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Visual Development Environment For 


WATGOM VX>Rexx is an easy to use visual development 
environment for creating applications that leverage the 
capabilities of OS/2 2.x and exploit the Presentation Manager 
graphical user interface. VX*REXxX combines a project 
management facility, visual designer and an interactive source- 
level debugger to deliver a very approachable and highly 
productive visual development environment. 


Powerful Open 

Environment Enjoy the 

simplicity of event-driven 

programming together with the 

global editing capabilities 
essential for professional project ¢ 
management. WATCOM : 
VXeREXx is open and extensible ‘ 
through IBM’s object oriented 

System Object Model (SOM) 


Design Applications 
Visually Create rich graphical 
applications quickly and easily using 
the visual design environment. With 


Integrated Development 
Environment Build, test and 
debug your application without 
leaving the development 


technology. You can access all 

standard REXXx API’s including | 
DB Manager, because V X*REXX ‘ 
is based on the OS/2 2.x standard 


the visual designer, you can 
graphically create Presentation 
Manager interface objects, quickly 
customize their properties, and 
easily attach REXx procedures to 
the objects. 


environment. Then package your 
application as an EXE file or PM 
macro for royalty-free redistribution. 
The power of the integrated 
development environment and 
debugger can also be used with your 
existing REXx applications. 


system REXX. 












Highlights 


> Easy to use visual development environment 

















> Support for multi-threaded applications 


» Create and modify objects dynamically at > Include OS/2 style help and hints in your 
both edit and run time applications 

> Powerful project management facility > Supports SAA CUA’91 objects 

> Advanced interactive source-level debugger > Autosizing and alignment of objects 

> Package your applications as EXE files or > \ntegrated console window support for 

| PM macros existing Rexx programs 

> Access to standard Rexx API's including > Royalty-free run-time available 
DB Manager | > Multiple modeless window support 

> System Object Model (SOM) based object Greats PAM Tmactos for aoplications 


manager supporting Rexx as a macro language 


Interactive Debugging 
If an error occurs at run-time, 
VX*REXx will display a traceback 
pinpointing the source line where 
the error occurred. A simple click 
of the mouse will return you to the 
source edit window to correct the 
error. The built-in interactive 
source-level debugger lets you set 
breakpoints, step through code 
and watch variables to track down 
complex problems. 




















Build Professional 
Applications 
WATCOM VX°RExx allows 
you to leverage key OS/2 features 
to create professional applications. 
Build applications that dynamically 
create and modify CUA’91 screen 
objects at both edit and run-time, 
and include OS/2 style help and hints. 


Create Multi-Threaded 
Applications Every VX-Rexx 
application contains multiple threads. 
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One thread remains responsive to user ated soul geveloP™ 
input while others continue processing. The integ! your projee 
In addition, VX*RExx provides the sim ¢ 


ability for advanced applications to easily 
use additional threads. 


Suggested Retail: $299 
Introductory Offer $99* 
(until September 30, 1993): includes royalty-free runtime 
Call Toll Free 

1-800-265-4555 








WATCOM VX-REXx: 
The integrated visual 
solution builder for OS/2 2.x. 





WATCOM International 
415 Phillip Street, Waterloo, Ontario, Canada, N2L 3X2 

Phone: (519) 886-3700 Fax: (519) 747-4971 

"Prices and specification are subject to change without notice. Price does not include freight and taxes where applicable. Prices 


quoted in US dollars. WATCOM, the Lightning Device, and VXeRexx are trademarks of WATCOM International Corporation. Other 
trademarks are the properties of their respective owners. © Copyright 1993 WATCOM International Corporation. 


Youre closer to Chent/Server 
than you think. 


There are plenty 
of choices of GUI 
builders, plenty of 
choices of databases, 
there are even choices 
of cross-platform 
communications, but 
Micro Focus is 
uniquely qualified to 
provide complete 
client/server solutions 
for your industrial-strength applications today. 

The Micro Focus Client/Server Solutions 
encompass an open framework allowing you 
to choose Micro Focus’ best tools for tasks 
such as building graphical 







user interfaces or handling 
program to program 
communications. 
Or, instead, plug 
in the tool of your 


choice. 
Micro Focus Client/Server 
Solutions provide middle- Whether you 
ware components so developers need only know how to 
lug into the appropriate platform. 1): 
ee ese are building 


applications with distributed data, distributed 


application code or distributed presentation 


Micro Focus is a registered trademark and “A Beuer Way of Programming” is a 





services, the Micro Focus Client/Server 


Solution is right for you. No matter what mix 
of thin or thick clients, or thin or thick servers, 
you will find it all in one place. And, best of all, 





; T 
the Micro Focus Client/Server Ke” 'SEp L 
¢ 
products provide a bridge from ? 
the old to the new, leveraging 
existing resources with the 
latest technology. s 


For a brochure on the 
Micro Focus Client/Server Solution, call 
800-872-6265. Discover how Micro Focus 
delivers “A Better Way of Programming*” 

rus 


: ; . a a ise 
Micro Focus, Inc., 2465 East Bayshore Road, Palo Alto, CA 94303. Tel. (415) 856 4161 


trademark of Micro Pocus, Inc. All other trademarks are property of their respective companies 
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The best-looking BASIC 
you've ever seen. 


a ee Ne =. 
_  CATextor § CACompete! 
This is what OS/2 is all about. | | a processing and project man- 
Making your PCs do more than |” \S -. agement to accounting, 
ever before. i: . spreadsheets and program- 


















Whichis why Computer | ming becomes faster — and 
Associates, the world’s leading | more affordable. 
software company, is pleased “psimalword process. Spreadsheet ease plus mul. Plus, you'll get the ulti- 
POROUCe SC” Re eee: mate in flexibility 
souped-up applica- | 5a ACCPAC . with this unprece- 
tine for Fifa set | eben ‘Simply Accounting CAGBFast dented offer: Buy 
Allare provenwin- | | ee the OS/2 version 
ners that fully utilize | __. ay Lge of any of these 
OS/2's unique ae Rr Be applications, and 
strengths. From the | we'll include the 
Workplace Shell to , Windows version 
truemultitaskingto  — “‘ogeibjobdone” —hasneverbeensimpler’ “apsisasnap, absolutely free. 
multimedia. For More Information, 

Businesses large and small will see benefits Call 1-800 CALL CAI Ext. 260. 
right out of the box with CA's easy-to-learn, Congratulations on choosing OS/2. Now 
easy-to-use programs. Everything from word add the right apps — and watch it really take off. 
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Editors 
Comments 


What's New, OS/2? 


ow that OS/? 2.1 is available, we can be 
more specific about the new release. In 
this issue, our writers give us an overview 
of version 2.1’s new features, plus a closer look at its 
CD-ROM and printing support. 





SPOTLIGHT ON TALIGENT 

What’s going on at Taligent, anyway? Many of 
you have asked that question, so we paid a visit to 
Mr. Taligent himself, Joe Guglielmi. Joe shares his 
view of Taligent’s world of objects and what it 
means to OS/2 developers. 


SPEECH RECOGNITION 


Everyone agrees that speech recognition will play 
a big role in the future of computing. Maybe we’re 
not quite ready for 2001's HAL but some applica- 
tions have put this cutting-edge technology to 
work today. In our first article on this fascinating 
topic, we'll look at a new OS/2 speech recognition 
development tool. 


PRODUCT WATCH 

We're adding a new department in this issue, called 
Product Watch/Calendar. It will tell you about the 
latest OS/2 tools and applications, upcoming shows 
and conferences, and new support programs for 


developers. Send us your press releases! 


NEWS YOU CAN USE 

Look for the latest OS/2 publication—the electron- 
ic IBM Personal Software Products Developer Support 
News. It’s on CompuServe and several other popu- 
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ou ae information: U.S.: One year (six issues), $39.95. Canada, Mexico, and international surface mail, add $16 per year for postage. Canadian GST no. 124513185. Inter- 
national air mail, add $30 per year for postage. Foreign orders must be accompanied by payments in U.S. funds. For new orders and customer service, call (800) WANT-OS2 
(800-926-8672) or (708) 647-5960 (fax: 708-647-0537). IBM employees and branch office customers can subscribe to the IBM O5/2 Developer through IBM Mechanicsburg’s Sys- 


lar bulletin board systems. In it, sasha find peer 
date news of IBM’s technical, , 
business, and marketing pro- | 
grams for developers. For more 
information, drop an Internet 
note to dsnews@vnet.ibm.com. 


MORE OS/2 MORE OFTEN 
Does our cover say “July/ 
August”? That’s no misprint— 
OS/2 Developer just went bi- 
monthly. Now we'll be coming to you six times a 
year instead of four; that means some challenges 
for our staff but a bonus for our readers. We'll 
have more news in the months ahead. Watch this 
space... 


Dick Conklin 
Editor 





Dick Conklin 
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Taligent, a joint project of IBM and Apple, is redefining the computer industry and our way of looking at the cre- 


ation of system software. BOB ORFALI and DAN HARKEY explore. 


Taligent: A New Paradigm, 


A New Approach 


0 OS/2 developers, Taligent can seem like a 
“Land of Oz” of operating systems, located 
“somewhere over the rainbow.” Why 
worry about Taligent when our brain cells are 
overloaded just trying to digest new OS/2 features 
like DSOM, the microkernel, DCE, LAN NetView, 
and motion-video multimedia? Why should OS/2 
developers like us need to know about Taligent? 
At least that was our attitude when we began this 
article—but it soon became evident that there was 
a lot about Taligent that OS/2 developers need to 
know about. 








Bob Orfali 


A New Paradigm? 
The first thing we discovered about Taligent is that 
its technology is multifaceted, elusive, and would 





Dan Harkey 


Figure 1. How IBM operating systems evolve and relate 
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not fit neatly into our current model of “the way 
things are.” For this article, we were not provided 
with specifications, product sheets, demos, or an 
architecture reference model. And this operating 
system is not like any other; it’s all new and differ- 
ent. When we expressed our bewilderment to 
Mike Potel, Taligent’s vice president of technolo- 
gy, he joked, “Joe Guglielmi had the same problem 
when he became CEO at Taligent. Every time he 
talked to somebody, he got a different view of this 
beast.” 

This article starts by looking at Taligent from an 
OS/2 perspective and provides a framework for the 
terminology of the interview. We then turn the 
microphone over to Joe Guglielmi. We could never 
match Joe’s eloquence and passion for his product. 





GS/2 and Workplace OS 

When does Taligent enter the picture? In Figure 1, 
we offer a “fearless forecast” of how the desktop 
operating systems from IBM and Taligent come 
into the picture over the next few years. In all 
cases, the future lies in operating systems that 
embrace object-oriented technology. OS/2 2.x is 
optimized for Intel processors and will continue 
to evolve throughout the ‘90s. The Workplace OS 
is a portable environment that is designed to run 
on top of Intel and RISC hardware from a variety 
of vendors, with the portability layer provided by 
a common microkernel. The 32-bit OS/2 applica- 
tions you create should run on all platforms. 

In our scenario, objects become very important. 
Distributed object services based on the System 
Object Model (SOM) become a vehicle to share 
objects across operating systems such as OS/2, 
DOS, Windows, UNIX, AS/400, and MVS. In 
addition, object-oriented application frameworks 
containing both IBM and Taligent technology will 
be offered for OS/2 2.x, UNIX, and Workplace OS. 

In Figures 2 and 3, OS/2 2.x and the Workplace 
OS support DSOM, object services, and the object- 
oriented application frameworks. OS/2 2.x contin- 
ues to evolve, providing optimal performance on 
the large installed base of Intel machines. 


A Guide to Microkernels, 

Personalities, and Frameworks 

Figure 3 helps explain all the new terminology and 
shows where Taligent fits in. Several pieces of the 
Workplace OS play together: the IBM Microker- 
nel, the operating system personalities, the distrib- 
uted object layer, the object-oriented frameworks 
containing Taligent technology, and the Work- 
place user interface. We will briefly introduce 
these pieces, then move on to Taligent. 


The IBM Microkernel utilizes technology from Mach 
3.0 research. Mach 3.0 is a portable microkernel 
developed by Carnegie Mellon University. The IBM 
microkernel and Mach 3.0 remove the UNIX-specific 
elements and provide a few well-defined services— 
including interprocess communications, virtual 
memory, ports, task dispatching, and threads—used 
to build all system services. The rest of the operating 
system functions—file I/O, user interface services, 
device drivers, and communications—are imple- 
mented outside the microkernel. As a result, the 
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microkernel can be smaller, faster, and more scalable 
while providing a higher level of robustness, securi- 
ty, and integrity. Elements outside the microkernel, 
such as the device drivers and file systems, can be 
shared by the operating systems that run on top of it. 
IBM's multithreaded microkernel supports symmet- 
ric multiprocessing, a technique that allows pro- 
grams to run concurrently on multiple processors in 
tightly-coupled configurations. It is intended to sup- 
port Intel and a variety of RISC processors. 






Taligent He 


laligent At A Glance 


Aral in March 1992, Taligent is an independent system 
x owned jointly by Apple Comp ter in. and IB BM Corp. 
fe quartered in Cupertino, Calif. The company has 310 Goes: 
who use object-oriented technology to develop system : 
the yany's charter is on enabling 
who spawned the desktop revolution, 
age of object technol 
encouraging a new model for innovation centered arour 
gent's system software will be open for extension at all lé 


bottom up. The emphasis of the co | 
the innovators and entrepreneu 
allowing them to take full advanti 








le age 











software from 


y's benefits and 
objects. Tali- 
by soft- 





ware developers, hardware OEMs, and systems vendors. The company 
will license, market, and support its software platform worldwide. 


Personality modules provide operating system-spe- 
cific API services. IBM intends to support DOS, 
Windows 3.x, OS/2 2.x, and UNIX personalities, 
with the microkernel concurrently executing mul- 
tiple operating system personalities on one 
machine. (One personality, designated as domi- 
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Figare 2. The Workplace Shel! OOU! for OS/2 2.x 


Figure 3. The Workplace OS 


nant, controls the appearance of the 
desktop.) The personalities will preserve 
investments in code and application 
packages. The microkernel also provides 
the means to build specialized servers 
and operating system replacements. 


The distributed object layer, based on 
IBM’s Distributed System Object Model 
(DSOM) technology, allows objects to 
operate across networks. This layer also 


includes services for storing, replicat- 
ing, shadowing, creating, destroying, 
and specifying objects. DSOM is based 
on standards set by the Object Manage- 
ment Group (OMG), an industry con- 
sortium of over 200 member compa- 
nies. For example, DSOM defines 
objects using the Common Object 
Request Broker Architecture (CORBA) 
interface definition language. DOOM 
uses OMG'’s specification of an Object 





Request Broker (ORB) to find and 
invoke objects on different machines. 
The object services are intended to 
comply with OMG’s object life cycle 
and persistence specifications when 
they become available. OMG and IBM 
are also working on specs for shared 
objects and object transactions for 
client/server environments. All this 
means that OS/2 is already deeply 
involved in objects, adhering to current 
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industry standards. These objects are, 
of course, built on top of a standard 
operating system. 


The object-oriented application frame- 
works intend to provide a portable dis- 
tributed set of object services to help 
create user applications. A framework 
makes writing object-oriented applica- 
tions from raw class libraries less 
tedious; you begin with complete 
working subsystems, which can be 
customized for individual applications. 
You can also create applications by 
wiring subsystems together with visual 
application assembly tools. Third party 
software companies will be able to pro- 
vide parts or entire components that 
can be assembled or modified by users 
or system integrators. 


The user interface for IBM's “Workplace” 
line is (you may have guessed from the 
name) based on OS/2’s Workplace 
Shell. This object-oriented user interface 
will be adapted for DOS, UNIX, and 
OS/2. Users think in terms of directly 
manipulating objects on the desktop 
rather than dealing with programs and 
other computer-based metaphors. IBM 
is working on making the user interface 
even easier to use by adding powerful 
new visual metaphors. 


ow that we've introduced 
some of the terminology, we 
give the floor to Joe Gugliel- 
mi, the chairman and CEO of Taligent. 
We used the system detailed in Figure 3 
as a reference point for our questions. 





Developer: Let's start with one of the loftier 
questions, Taligent was jointly founded by 
IBM and Apple. What were your original 
goals, and how have they changed? 


Joe: When Apple and IBM got together 
on this project, it was because both com- 
panies had a common vision of the 
importance that object-oriented technol- 
ogy would have in the marketplace. 
Both had substantial interest and invest- 
ments already in that technology. We 
first looked at a joint development 
using the Power PC RISC chip and then 
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it grew into a more encompassing pro- 
ject that would commercialize objects on 
high-volume platforms and get the 
industry to make the transition from a 
procedural world to an object world. 


Joe M. Guglielmi 


fully integrated into an operating form. 
So as a kind of a Lucky Strike Extra, 
you get to do those in an integrated 
fashion. By the way, in an object sys- 
tem all those things become simply 








Joe Guglielmi, 51, is chairman and CEO of Taligent, Inc. He moved to Taligent 
from IBM, where he was general manager of marketing and business develop- 
ment for the Personal Systems Line of Business. In his 30-year career at IBM, 
Guglielmi designed the business strategy for IBM's first successful minicomput- 
er line, helped establish a division for marketing IBM's first PC products, and 


established IBM's first alliances with PC application companies. 


Why is that so important? 


Because our goal is to provide a dra- 
matic improvement in the application 
development environment. I talk about 
it in terms of moving the cycle from 
years to months and providing a brand 
new environment, in terms of function- 
ality, that will encourage innovation. It 
also turns out that, since we're writing 
an operating system from scratch, we 
get to do some things right. We now 
have a rich heritage in multimedia, 
advanced graphics support, and other 
capabilities that we know should be 
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objects that you can deal with. You 
don’t worry about whether you're 
dealing with full-motion video or 
whether you're dealing with static data 
types. Everything is treated as an object 
structure. 


ey Vi cae iw dal . ‘mor? 
Where do you see this technology going: 


We see enormous potential in this tech- 
nology—not because it’s object-orient- 
ed, but because it can give the industry 
a brand new base that will allow us to 
move from today’s environments, 
which are constrained, we think, by the 
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operating system capabilities. Just as 
OS/2 2.0 unleashed the power of a 
microchip we'd been shipping for years, 
this will begin to unleash the power and 


creativity in the industry in a different 
way. We won't be constrained by the 
old paradigms of procedural operating 
systems. 


How will you get this technology into the 
marketplace? 





This is where our strategy has changed 
dramatically. Initially, the notion was 
to deliver one large brand-new operat- 
ing system, top to bottom, in one really 


“What we provide is an environment that lets 
(developers) do a much better implementation of 
what they do best.“ 


significant drop. We’ve become more 
realistic about that; we’ve had to deal 
with very pragmatic issues. How do 
we, when providing this great step 
function, deal with current invest- 
ments? How are we going to make sure 
the OS/2 investments, AIX invest- 


06d GUI ist’ Always Cle 2 


ments, System 7 investments carry for- 


ward? How do we ensure that we don't 
force a change in the marketplace all at 
once to a new technology? 


So how do you do that? 


We've focused our strategy over the last 
year on three or four things. One is 
moving the project from a research pro- 
ject with two or three technology bases 
to a product development environment 
where we now have the focus on deliv- 
ering products that respond to cus- 
tomers’ requirements to the market- 
place. Second, we've spent a lot of time 
staging the project... we can’t do it all at 
once. We'll never be able, in one release, 
to compare to those established operat- 
ing systems, so that’s a bad goal. So let's 
focus on areas in which we think the 
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technology substantially leverages itself. 
We're going to stage our technology to 
focus on both corporate and software 
developers. What do they need first, to 
provide value? Taligent’s proposition is 
that the value comes from the develop- 
ers. We don’t compete with them for 
word processors or spreadsheets, and 
we don’t do databases. What we pro- 


operating systems like OS/2, AIX, and 
System 7. That’s a pretty profound 
change. That's something that’s not 
very natural for a team developing a 
new operating system to do. A devel- 
opment team wants to make the 
biggest step function change, one that 
differentiates between current and 
future environments. Well, we con- 


“We benefit if IBM and Apple evangelize object 
technologies and provide us with a more 
evolutionary path. We re a small company, 


~ wecant do it all ourselves. ~ 
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vide is an environment that lets them do 
a much better implementation of what 
they do best. Our delivery channels— 
Apple, IBM, and others—are also going 
to add value to this. 


Yes, but every new operating system needs 
to do that kind of stuff... 


It does. But the second new notion is 
that we would take pieces of this tech- 
nology and make it available to current 


cluded that without some strategy to 
get the technology into the market 
early, the step function was too great. 
This isn’t 1983 anymore. This isn't 
about “I have a great technology; we'll 
just get people to stop what they're 
using and move over to it.” We have 
example after example in the market- 
place today where great technology 
can’t get commercial acceptance. So the 
notion was, why don’t we take pieces 
of this technology and make them 


IBM OS/2 


available to current operating systems? 


What does that do for those operating 
systems? 


First of all, if we’ve done classy imple- 
mentations of the technology, it will 
enhance them. OS/2 will be more com- 
petitive; System 7 will be more competi- 
tive. By the way, we're not limiting it to 
just those two; our strategy is to go after 
as many of the current operating sys- 
tems as possible. Think about all the 
UNIX environments or—ultimately— 
any 32-bit system that can carry the 
technology. 


What are the benefits to Taligent of mak- 
ing this technology available to others? 


The technology will make OS/2 and 
System 7 more competitive and they, in 
turn, will provide us a transition plat- 
form for the wide-scale introduction of 
objects to the marketplace. We benefit if 
IBM and Apple evangelize object tech- 
nologies and provide us with a more 
evolutionary path. We're a small com- 
pany; we can’t do it all ourselves. But 
by putting pieces out in the market- 
place, we begin to provide a transition 
mechanism—that Is, investments made 
in applications that use that technolo- 


DEVELOPER 


gy under a mature operating system 
can be carried forward into Taligent 
when the time is right. So when Tali- 
gent comes, customers can decide 
whether they want to move to it or not. 
This is not a forced march. It doesn’t 
mean one Monday morning OS/2 goes 
out of business or System 7 goes out of 
business—that’s not the strategy. 


But if you've made your object technology 
available on other platforms, why would 
anybody ever want to move to Taligent? 


Taligent will be fully object-oriented 
with a very consistent object model. 
When you enter Taligent, everything in 
the system is an object, with no differ- 
entiation between a system object and 
an application object. We can imple- 
ment a very consistent object structure: 
once you're in the object space, you can 
leverage every element in that environ- 
ment. You won't ever have to deal with 
the procedural elements of a system. 
Take NextStep, for example. Steve 
(Jobs) has a great user interface tool, 
but you still have to bounce into UNIX 
from within your applications. 


What are the advantages of having objects 
at the operating system level? 


Envision a growing industry that 
would provide system frameworks, 
networking frameworks. Take commu- 
nications... If they don’t like ours, IBM 
or Novell could replace it with their 
own implementation. Device adapters 
can inherit characteristics of a particu- 
lar device class and customize them to 
fit their particular needs. It’s a very 
consistent way of taking advantage of 
new hardware. System software can 
then keep up with fast-moving hard- 
ware technology. 


OK, so what's in it for application software 
developers? 


If we do our job right, in the mid-90s 
application developers will not be writ- 
ing code but will instead be shopping 
for objects. If you think about it, there 
will be thousands of objects; how do I 


know which one I want to subclass or 
reuse? We're building a very consistent 
development environment with view- 
ers or browsers that let you try out 
these objects and understand what they 
can do for you. You'll have a full 
envirionment that lets you think of 
your world in terms of objects. 


Will some of that environment be made 
available on OS/2? 


Yes. I didn’t mean to imply that the 
layers of components we provide for 
OS/2 won't be great; they’ll move 
objects forward and condition the mass 
market for objects. Taligent has the 
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Speech recognition is here! 
Introducing ICSS, the IBM Continuous 
Speech Series. A developer's foo! that has 


the flexibility to speech enable your 
programs. This software product provides 
total speaker independence—there’s no 
special voice training required. If some- 
one can talk, they can use your speech 
enabled program. And ICSS also features 


“continuous speech"—allowing you to 





A SENSE OF HEARING. 





speak completely naturally, the way you 
would to a friend. With a 1,000 word 
active grammar that is dynamically 
switchable, the possibilities are limitless. 
ICSS runs on 486DX machines running 
05/2 2.x, as well as RISC/6000 
machines running AIX 3.2. For more 
information, call 1-800-627-8363. 
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added luxury of being able to put the 
whole thing together from the bottom 
to the top. 


Speaking of the bottom, both Taligent and 
OS/2 will be running on the same Mach 3 
microkernel—is that correct? 


We're on the same microkernel, but 
IBM is not shipping Mach. They’re 
shipping a microkernel based on Mach 
technology. Mach is a big, heavyweight 
thing; IBM and Taligent are creating a 
much more lightweight version of 


Mach and creating personality-neutral 
servers and services. Taligent is adding 
the mechanisms to make it a first-class 
object environment. We’re working on 
the performance implications of mov- 
ing thousands of objects around in a 
system. IBM will build the microkernel 
that we'll use as part of our common 


strategy. 


Mach is an open microkernel, something 
perceived as a benefit. Aren't you losing 
that by going to your own microkernel? 


I’m not commenting on the open 
aspect. I’m commenting on Mach’s 
poor performance for doing objects. We 
have over four years of experience 
writing microkernels for objects, and 
we know how to do one. Object people 
don’t think you can do objects on the 
current version of Mach—it may be OK 
for doing UNIX-type things. The com- 
mon IBM microkernel solves those 
technical problems. On the openness 
question, it’s up to IBM how they sup- 
ply the microkernel back to the indus- 


try. I’m trying to answer the guy who 
says, “What are you, nuts? Mach can’t 


run an object system the way it’s cur- 
rently designed.” The answer is “It 
can’t, but the kernel we’re implement- 
ing can.” It’s really this notion that the 
core technology is optimized object 
technology and this new common 
microkernel works across OS/2, UNIX, 
and ultimately, hopefully, the industry. 
That’s where the world’s going. 


So is this microkernel one of the first pieces 
to be delivered? 


“In Taligent, we are dealing with a system opti- 
mized for a very large number of small objects.... 
We don't move a few big objects. We move a lot 
of very little things around, so we have a tremen- 
dous amount of tasking going on.” 


It’s actually being developed at IBM. 
Our operating system development 
team is working with the IBM team. 


Are your object frameworks built on SOM 
and CORBA technologies? 


I think we’ve come to appreciate what 
SOM is and what it isn’t. I think there’s 
a greater feeling that SOM’s design 
point and the problem set that it solves 
are important, very important. Whether 
or not we can, as a team, adopt all of the 
goals of SOM in our design point is the 
discussion we're having with IBM now. 
The reason is, I think, pretty neat to 
think about. In Taligent, we are dealing 
with a system optimized for a very large 
number of small objects. That’s how we 
get performance. We don’t move a few 
big objects. We move a lot of very little 
things around, so we have a tremen- 
dous amount of tasking going on. We've 
got the machine burning and we've 
optimized for performance. We gota lot 
of value out of that optimization. SOM 
is best when the primary objective is 


mixing objects from a variety of ven- 
dors. The fact that the object's interface 
is the standard defined by the Object 
Management Group—the CORBA spec- 
ification—is also very attractive. 


Will you support DSOM then, since it’s 
based on CORBA? 


Of course. DSOM is a very easy case. 
Its ORB, which is CORBA compliant, is 
one way we deal with objects across 
networks. We know there are objects 
on this network that are going to be 
moved around. 


So you're depending on DSOM to bring 
CORBA. Is IBM representing Taligent's 
position in the OMG? 


IBM, like Sun or HP, has put some time 
into defining the CORBA compliance 
specs. In our implementation, we sup- 
port that spec as one of the important 
distributed object models in the indus- 
try. Now take Microsoft: they're doing 
CAIRO. I don’t know if CAIRO is 
CORBA compliant; the likelihood is 
not. What's going to be our position on 
Microsoft's model? If it’s a high-vol- 
ume model in the future, we're going 
to have to find a way to support it as 
much as possible. That doesn’t mean 
we like it... or don’t like it. Our position 
is pragmatic. We have to exist with 
whatever becomes a high-volume plat- 
form in the future. We're working with 
IBM, Apple, and others to try to make 
the transition as seamless as we can, 
but we’re coming from two different 
worlds. What we won't do is subopti- 
mize our world. If we end up lowering 
our goal of full utilization of object 
technology, we will lose the great dif- 
ferentiation that comes from it. 


Which IBM groups do you work with on 
object technology? 


I deal through the PSP division, which 
means that Larry Loucks, Cliff Reeves, 
and Lee Reiswig are my contacts in the 
IBM world. So when I deal with Larry 
and Cliff, we either agree or don’t 
agree, and I expect them either to bring 
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the rest of the company with them or 
tell me that I’ve got to go deal with the 
situation differently. By the way, 
they're doing a great job evangelizing 
Taligent within IBM. 


and beyond. This will give you the high- 


est affinity with Taligent. Why do I say 


that? Because I’m working very hard to 
make that happen. Can I tell developers 
that everything they do in every release 


‘If you're an OS/2 developer, keep working with 
OS/2—telease 2.1 and beyond. This will give 
you the highest affinity with Taligent.... /m 
working very hard to make that happen.” 
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If you were speaking directly to, let's say, 
leading edge OS/2 application developers 
who want to do the right thing and position 
their product for the future, what kind of 
strategy or recommendation would you 
map out? 


Here’s the strategy I think has to be fol- 
lowed. If you’re an OS/2 developer, 
keep working with OS/2—release 2.1 


will be cared for seamlessly? No, I can’t 
tell them that. But they should know that 
we are working very hard with the PSP 
development group to put as much of 
this technology as possible into OS/2 
and AIX, to enhance their competitive- 
ness wherever we can, because we 
believe that’s good. We believe a big 
OS/2 base is in Taligent’s interest and, 
therefore, we’re going to work as hard 





as we can with IBM to make it as pain- 
less as we can. We hope it’s zero pain. 
That's our goal. But it probably won't be. 


How do you balance that with Apple's 
needs? 

The same way. When we talk to Apple, 
I have the same strategy. The decisions 
we make optimize on where Taligent is 
going, mindful of the fact that helping 
make Apple successful with System 7 
and IBM with OS/2, AIX, and Work- 
place OS is good for us, because every 
user in those two or three camps is 
going to be positioned much better to 
come to Taligent. 


Will the Taligent user interface look like 
Mac, Workplace Shell, or something brand 


new? 


That’s unclear, frankly, and let me tell 
you why. I believe that the opportuni- 
ty to build the Taligent desktop com- 
pletely from an object paradigm gives 
us degrees of freedom that can move 
the desktop beyond what is possible 
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Now there’ a faster, easier, more affordable way 

to test your applications. Introducing Workstation i 

Interactive Test Tool (WITT) 2.1, for OS/2° 2.0. An 
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WITT does it all. Record, edit, playback and screen compare 
So once you've built a test case, 
Introducing you can use it over and over again. 


Workstat ion 


It works for applications on OS/2 


PM, and host-connected MVS, VM, 


Interactive VSE and OS/400° 
lest lool 2.1 Now regression testing is more 

What's more, WITT won't test your budget. Because it’s very 
affordable. 


reliable. New code testing is easier. 
a And learning is easier, too. With a friendly online tutorial. 

It only takes an instant to call 1 800 426-3346, ext. 64, and 

ask for more information and our free evaluation demo. Or, better 


yet, order WITT today with a no-charge two-month testing period 


and developer hotline assistance. 
a The instant you get WITT 2.1, you'll be more productive. 
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today. So we're focused on that; we’re 
trying to figure out where we can 
exploit this technology the best. Let's 
take one model that could happen. In 
a Taligent world, since everything is 
an object, applications don’t exist the 
way they exist today. You turn your 
system on and it comes up with a set 
of objects that you deal with, and you 
arrange them in workflows. The 
notion of a workflow world centered 
on the user is much more realistic in a 
full-object world. Everything on the 
screen is a full object linked from the 
top to the bottom of the system. When 
we are ready to deliver a full-object 
model to the screen, we're going to go 
back and work with IBM and others 
on where they are today. We'll try to 
make it as evolutionary as we can... 
we'll find ways to see if we can’t 
evolve multiple releases of the Work- 
place Shell or the Mac look to where 
Taligent is heading. 


What's your planning horizon? 


We're the only ones in town who are 
worried about 1996. I don’t mean that 
in a negative way. Everybody else is 


worried about 1993, ‘94, and “95. I have 
to stay worried about 1996, or ‘97: how 
can this technology, when it’s fully 
exploited, change the playing field in 
the industry? If we miss the goal of pro- 
viding dramatic new technology, the 
industry won’t change. If the industry 
doesn’t change, none of the interim 
operating systems are going to be suc- 


cessful by themselves. They will not 
have the kind of critical mass that you 
require. So the design point is to fully 
exploit the technology and then look 
backwards to see how we move the cur- 
rent base from here to there, and there 
are several bases. But the thing people 





ought to feel good about is that we're 
thinking about it. It’s not like we're over 
here doing our best thing and hope that 
someday it all works. This is the first 
time there is a group that is allowed to 
really focus on where we want to be, At 


“| will tell you this: both Apple and IBM feel 
strongly about keeping their current systems 
viable, and we support that. Theres no mode! 
here, under any circumstance, where all of a 
sudden on Monday morning OS/2 or System 7 
goes away.” 


IBM, you know that there can be terri- 
ble constraints on getting there when 
you must suboptimize to support the 
core installed base. But we don’t want 
to look like we never talk to each other, 
either, so we have a new development 
model here, It’s different than we've 
ever tried before, and that’s why Tali- 
gent is a separate company. 


Will Taligent technology bring together the 
System 7 and OS/2 worlds? 


As a separate company, | can talk with 
a lot of authority about what we’re 
doing, and | can tell you only a little bit 
about how we're working with these 
two companies. If you want their view 
of the world, you've got to go ask IBM 
and Apple. I will tell you this: both 
Apple and IBM feel strongly about 
keeping their current systems viable, 
and we support that, There’s no model 
here, under any circumstance, where 
all of a sudden on Monday morning 
OS/2 or System 7 goes away. That isn’t 
in the cards, because there’s no viable 
scenario where this whole thing can 
make the transition in one day to a new 
environment, So there is going to be, as 
you expect, a continuation of a substan- 
tial investment in those current operat- 
ing systems, and we're going to find a 
way to make the path to Taligent very 
attractive. 


Are you going to sell a shrink-wrapped Tal- 
igent through software stores? 


Yes, but that isn’t our model. The 
whole distribution model is changing 
today. The store distribution model is 
going away; I mean, who distributes 
operating systems today? The hard- 
ware manufacturers. So our strategy is 
to get the distributors to accept the 
technology, to provide the critical mass, 
the target volumes, so that developers 
can see it. Shrink-wrap and user sales 
will come after that. So the whole 
model is different. It isn’t about run- 
ning big ads in magazines, hoping that 
users will ask developers to create a 
great application. It’s about going to 
developers and saying, “Look, you're 
building a great application. You can 
keep doing it. We're going to give you 
the tools to do it in a third of the time 
and to maintain it more easily by an 
order of magnitude. You know, by the 
way, that when you upgrade it, your 
cycle will go from two years to six 
months. That’s worth a lot by itself. Oh, 
there’s another opportunity coming. 
Have you thought about spreadsheet 
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Down the road, the shortcomings 
of other client/server development tools are 
certain to become apparent. 
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The people in your company who rushed 
out and acquired fancy little GUI builders 
may be buzzing right along with them. 

But what happens when those same people 
need to connect to information outside of 


their department? Or when their user ranks 


1-800-OBJECTS swell and data flow begins to explode? Or 


when they decide they want to take advantage of the power inher- 


ent in the latest release of OS/2? Or when they need to support 
client/server models beyond a simple Database Server architecture? 
It's in situations like these when most application develop- 
ment tools show their weakness. And when Easel's robust solu- 
tions display their considerable strength. 
ENFIN™ is the perfect solution for organizations that want 


to use an industrial-strength object-oriented development 


environment to build their client/server applications. 

Enterprise Workbench” delivers cross-platform development 
solutions and unsurpassed connectivity options for building 
new client/server applications. 

EASEL Renovator+™ allows organizations to extend legacy 
applications into the client/server world. 

Importantly, each of these visual development environments 
offers benefits that go well beyond those of mere GUI builders. 

We have a White Paper that describes the five models of client/ 
server computing and explains how Easel products support every 
one of them. For a free copy, phone us at 1-800-OBJECTS. (Calling from 
outside the U.S, and Canada: 617-221-3014.) = 


ASEL 


Corporation 


Otherwise, when you want to develop 
enduring, enterprisewide solutions, you 


may find yourself hitting the wall. 


©1993, Easel Corporation, 25 Corporate Dr., Burlington, MA 01803. All Rights Reserved. ENFIN, Enterprise Workbench and Easel Renovator + are trademark of Ease) Corporation. All other trademarks are the property of their respective holders, 05 
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engines, word processor engines, 
graphics engines? Have you thought 
about work flow as an application? You 
can really do it now. Have you thought 
about it?” So we're creating a different 
world of applications and when we 
start this model, all of these characteris- 
tics will allow hardware manufacturers 
to differentiate their products. 

We want to sell through the high- 


volume channels. If we don’t do that, 
our adoption curve is going to be seven 
years. It takes seven years to get an 
operating system to the market, if 
you're good. I want to be a success 
faster than that. So all of these strate- 
gies are working toward substantially 
reducing the adoption curve for the 
new technology. 


How do you see the operating system pie 
divided in 1996? 


I'd be presumptuous to give you a tar- 
get, but I will tell you that existing sys- 
tems will continue to have a large mar- 


ket share. Between now and 1996, 
there’s just not enough time to substan- 
tially change the rate flow. I don’t 
know what the division between NT, 
DOS, OS/2, and Windows will be; who 
knows? That's completely up to them. 
We haven't seen NT yet, but they'll 
have a large share. I believe OS/2 will 
gain critical mass and have a substan- 
tial share. I think Apple will continue 


“We want to sell through the high-volume 
channels. [f we dont do that, our adoption curve 
Is going to be seven years. It takes seven years to 
get an operating system to the market, if you re 
good. | want to be a success faster than that.” 


to have a big share. UNIX will probably 
still own eight or nine percent of a 
growing market. By 1995 there'll be 35 
million micros shipped per year, so 
even 10% of that is still a big volume. 

And then Taligent will begin to 
show up. Now I can’t tell you exactly 
how big our wedge will be, but it will 
not be zero, because we intend to get 
to market by the mid 90s; hopefully 
earlier. And I think that, as Taligent 
becomes an important environment 
and we demonstrate its utility, that 
wedge will grow more rapidly than 
historical growth rates in new operat- 
ing systems. 
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RAIDION: -LT and 0S/2 


A Perfect Match. Introducing RAIDION LT fault-tolerant disk 
arrays for IBM OS/2 or LAN Server based systems. RAIDION LT 
and RAIDWARE™ management software combine to create the 
first modular, RAID level 5 fault-tolerant storage subsystem 
designed specifically for use with OS/2. 


Reliability Plus. The LT offers the features you expect of a 
fault-tolerant storage subsystem, and then some. The Hot 
Swap of individual modules is fast and easy. An On-Line Spare 
option enables the subsystem to remain operating in a fault- 
tolerant mode even if one drive in the array fails. RAIDION LT 
is designed to give OS/2 users 100% data availability, 100% of 
the time. 


Easy to Install, Easy to Upgrade. Individual disk modules, 
with either 560 megabytes or |.0 gigabytes of formatted 
storage, are combined to make a three-module array of either 
1.2 or 2.0 gigabytes. And increasing capacity is simple. Add one 
or more modules to a three-module stack to increase capac- 
ity. A total of 4seven-module stacks can be combined to 
provide up to 28 gigabytes of fault-tolerant storage. 






For more product information or the name of your nearest authorized 
RAIDION distributor call 1-800-395-3748. 
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The release of OS/2 2.1 presents software vendors with a platform for developing 32-bit OS/2 applications and 
tools as well as DOS and Windows applications. Its new and enhanced features let developers exploit emerging 


PC technologies BY MIKE KAPLY 


The Release of OS/2 2.1: 


An Overview 


$/2 2.1 has many major and minor 

enhancements, including better device 

support (CD-ROM, SCSI, video, and print- 
er), WIN-OS/2 3.1, a 32-bit graphics engine with 
32-bit seamless drivers, ISO-compliant fonts, 
advanced power management, Personal Comput- 
er Memory Card International Association (PCM- 
CIA) support, inclusion of Multimedia Presenta- 
tion Manager/2, and pen and security “hooks.” In 
addition, improvements have been made to the 
overall performance, specifically to WIN-OS/2 3.1 
and the Workplace Shell. Figure 1 is an overview 
of the OS/2 2.1 system components and the major 
areas in which service fixes and enhancements 
were made. 


OS/2 2.10N CD-ROM 

With the success of CD-ROM Professional Develop- 
er’s Kit, IBM is shipping OS/2 2.1 on a CD-ROM with 
two accompanying disks to begin installation. The 
upgrade is also available on 3 4° and 5 4" disks. 


DEVICE SUPPORT 
CD-ROM and SCSI support has been improved in 
OS/2 2.1; OS/2 now provides support for CD- 
ROMs from eight manufacturers: Hitachi, IBM, 
NEC, Panasonic, Sony, Texel, Toshiba, and CD- 
Technology. SCSI adapter support includes 
Adaptec, Future Domain, DPT, and IBM adapters. 
More display drivers are also provided in OS/2 
2.1, with seamless video drivers included for 13 
SVGA adapters including Tseng, ATI, Western 
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Digital, Headland, and Trident. 8514/A support is 
now provided on 32-bit seamless drivers. Other sup- 
ported video modes are VGA, XGA, and XGA-2. 
Depending on the driver and the hardware configu- 
ration, these drivers can support resolutions as high ~ 
as 1024-by-768 with 256 colors and 800-by-600 with 
65,536 colors. 


The 32-bit model removes the 64K 
segment limits, increasing the limits on 
most resources including the number 
of definable points and handles. 





PRESENTATION MANAGER 

A new 32-bit graphics engine, first available with the 
Service Pak in October 1992, gives faster, more accu- 
rate graphics performance. The major changes are: 


e 32-bit model 

¢ Increased limits 

New GpiPolygons API 
Addition of Palette Manager 
ISO-compliant fonts | 
Improved performance 
32-bit seamless drivers. 
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Workplace Shell 

Desktop User 
Interface 

Command Prompts 


SOM 
Objects Handlers 
Class Libraries 









Physical Device Drivers 
Basic Device Drivers (e.g., keyboard and mouse) 
Disk Device Drivers (SCSI and Non-SCSI) 

SCSI Peripheral Device Drivers (e.g., CD-ROM) 


Control Program 





Kernel 
Processes FAT 

| Memory HPFS 
IPS | CDFS 


Figure 1. OS/2 2.1 system components overview 


The 32-bit model removes the 64K 
segment limits, increasing the limits on 
most resources including the number 
of definable points and handles. Tables 
1 and 2 show how some limits have 
been increased. 

The new GpiPolygons API improves 
high-speed drawing of polygons; the 
32-bit implementation removes prior 
restrictions and provides a faster, more 
powerful mechanism for drawing one 
or more polygons. (For more informa- 
tion about the GpiPolygons API, see the 
OS/2 2.0 Programming Guide, Vol. 3.) 

The palette manager allows devel- 
opers to take full advantage of SVGA 
and XGA drivers displaying 256 col- 
ors. Applications can now define their 
own colors instead of relying on 
dithering or closest fit. For more infor- 
mation, see the OS/2 2.0 Programming 
Guide, Vol. 3. 

Another change to the graphics 
engine is the introduction of ISO fonts 


that conform to the ISO 9241-3 stan- 
dard. Use of these fonts is optional; 
however, the System Proportional font 
is replaced in OS/2 2.1. All other ISO- 
compliant fonts are provided in addi- 
tion to the original OS/2 fonts. 

The performance of the graphics 
engine has been improved by the 
removal of many “thunks” within the 
system. Also, many graphics opera- 
tions were enhanced for better perfor- 
mance. 

Another important addition with 
the new graphics engine is the ability 
to develop 32-bit seamless drivers. 
These drivers provide better perfor- 
mance than their 16-bit counterparts. 
Note that in addition to the new 32-bit 
drivers, 16-bit drivers are still support- 
ed by OS/2 2.1. 


WORKPLACE SHELL 
Many improvements have been made 
to the Workplace Shell. The icons of 


File Systems 


Display Drivers 
Base Video Handlers 
PM Display Drivers 
| WIN-OS/2 Display 
Drivers (Full-Screen 
and Seamless) 

















Print Subsystem 
Spooling 

















Printer Drivers 
PM Printer 
Drivers 
WIN-OS/2 Printer 
Drivers 















Workplace Shell objects can now be 
changed by dragging and dropping 
any icon or object onto the General 
Page in the objects’ settings. In addi- 
tion, desktop notebooks now use a spi- 
ral binding instead of a solid binding. 
For security purposes, a new option 
allows users to lock up OS/2 automat- 
ically on system startup. The WPS also 
has improved memory usage and 
improved .INI file handling. 

Warning: If you have written Work- 
place Shell drag and drop code under 
OS/2 2.0, the way the ancestor classes 
respond to the _wpDrag0ver method has 
changed for OS/2 2.1. Specifically, the 
parent _wpDrag0ver method will return 
DOR_NEVERDROP if the ancestor classes can- 
not accept the source objects. Conse- 
quently, code must be written so that 
the parent _wpDrag0ver method is called 
first, and if the resultant Drop indicator 
is not DOR_NEVERDROP, then the method 
may continue its processing. 
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Table 1. Comparison of limits of 16-bit and 32-bit graphics engine 


| 





Table 2. 32-bit handle limits 


DOS SUPPORT 

Several enhancements have been made 
to DOS support in OS/2. A second 
thread has been introduced into the 
DOS sessions to allow for better com- 
munications and better synchroniza- 
tion of audio and video in multimedia 
applications. This function can be 
enabled with the DOS setting INT_DUR- 
ING_I0. Another new setting, DOS_AUTOEX- 
EC, allows individual AUTOEXEC.BAT files 
to be specified for each DOS or WIN- 


OS/2 session. This change lets applica- 
tion developers further customize DOS 
sessions for test scenarios. Other 
enhancements include the updating of 
DPMI to be a subset of the 1.0 standard 
and MSCDEX audio support in the vir- 
tual CD-ROM driver. 


WIN-OS/2 3.1 

WIN-OS/2 support in OS/2 has been 
updated to support Windows 3.1 appli- 
cations. An enhanced compatibility 
mode also lets many enhanced-mode 
Windows applications run. However, 
applications that require a VxD-type 
device driver will not run. Performance 
in WIN-OS/2 has been improved, espe- 
cially the clipboard and DDE functions. 
WIN-OS/2 3.1 also provides most of the 
applets shipped with Windows 3.1, and 





LinkRight by Rightware Inc. 


The only file transfer 
utility for OS/2. 


| 
LinkRight is a parallel port and serial port file transfer 
utility made especially for OS/2. The OS/2 versions are 32 
bit, multi-threaded tasks. For a single low price, you can 
get. a PM version, OS/2 command line version, and DOS 
version. 


Copy files and EAs to/from OS/2 to/from DOS systems. 
Subdirectories, hidden, system files, and newer files can 
be selectively copied. 

Batch file generation. Mark and immediately send files, or 
mark files and save them to a list. of files for later transfer. 
Features compression for faster transfers. Uses CRC 
checking to insure accurate transfers. Full support for long 
file names and HPFS. 

Copy the OS/2 operating system from one system to 
another in accordance with your licensing agreement with 
IBM 


Compatible with LapLink cables. 


For purchasing information call your favorite software distributor 
or Rightware Inc. (301) 762-1151. 


OS/2 is a registered trademark of International Business Machines Corporation. 
LapLink is a registered trademark of Traveling Software. LinkRight is a 
copyright of Rightware Inc. 


Moving up to OS/2 

from W indows? Let 

CUA Controls Library/2 
deliver your GUI baggage. 


If youre moving up to more powerful OS/2* from 
Windows:’ now you can have the same user interfaces for 
both new and existing applications. 

With CUA” Controls Library/2 (CCL/2). 

It's a 16-bit program that quickly generates familiar 
OS/2 2.0 GUIs for applications in OS/2 1.3 and Windows 
3.0 and 3.1. 

It provides consistent interfaces across platforms, so 
your end users will quickly learn new applications. 

CCL/2 contains the code for seven key GUI screens. 
It's code you won't have to write. It’s also code you can 
reuse. Over and over again. 

What's more, CCL/2 will save you money. Because 
there are no runtime charges for redistribution of DLLs. 

And because now it’ available at the low price of 


only $149. To order, call 1 800 342-6672. 


For information, fax | 919 469-4423. = SSs=" 
So get moving. With CCL/2. ==SST= 


IBM and OS/2 are registered trademarks and CUA is a trademark of international 
Business Machines Corporation. Windows is a trademark of Microsoft Corporation 
© 1993 IBM Corp. 
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a new function allows OS/2 and DOS a a ar, 


The following APIs have been added to OS/2. For more information, consult 
the online references available with the toolkit. 


applications to be started from within a 
Windows session. WIN-OS/2 3.1 also 
includes multimedia extensions as well 
as [ruetype font support, provided in 
addition to Adobe font support. 


LAPTOP SUPPORT 

On systems that support the APM 
(Advanced Power Management) stan- 
dard, OS/2 2.1 provides power-man- 
agement capabilities and a power applet 
to monitor battery status. PCMCIA sup- 
port is also provided; through socket 
and card services, PCMCIA cards can be 
removed and replaced while the 
machine is on. Interfaces allow device 
drivers to be allocated dynamically. 


MMPM/2 

OS/2 2.1 includes Multimedia Presen- 
tation Manager/2, a set of extensions 
that adds multimedia functions to 
OS/2 including image and audio sup- 
port, a multimedia control interface, 
support of various devices, system 
sounds, and several multimedia 
applets. Applets included with OS/2 
2.1 that were not available with 
MMPM/2 1.0 are a wave editor and the 
Ultimotion software motion video 
player. For more information about 
MMPM/2, see the References section. 


PERFORMANCE IMPROVEMENTS 

Extensive improvements have been 
made to O$/2's performance, including a 
reduction in the working set of OS/2, 
HPFS improvments, and scheduler and 
loader changes that provide faster execu- 
tion. In addition, there have been 
changes in some CONFIG.SYS parame- 


DosProtectClose 
DosProtectEnumAttribute 
DosProtectOpen 
DosProtectQuer yFHState 
DosProtectQuer yFileInfo 
DosProtectRead 
DosProtectSetFState 
DosProtectSetFileInfo 
DosProtectSetFileLocks 
DosProtectSetFilePtr 
DosProtectSetFileSize 
DosProtectWrite 
WinCheckInput 
WinLockPointerUpdate 
WinLockupSystem 
WinQuerySysPointerData 
WinSetPointerOwner 
WinSetSysPointerData 
WinUnLockSystem 


wpAddPowerPage 


Table 3. New OS/2 APIs 


FOR PROGRAMMERS ONLY 
The MMPM/2 Toolkit is now a part of the 
base OS/2 Toolkit; it does not need to be 


~ WIN-OS/2 support in OS/2 has been updated to 
support Windows 3.1 applications. 


ters to improve performance in memory- 
constrained environments. For detailed 
information about these changes, consult 
the OS/2 2.1 Technical Update Redbook. 


purchased separately. Also, several APIs, 
shown in Table 3, have been added to 
OS/2. For more information, consult the 
online references available with the Toolkit. 
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wpAddPowerViewPage 
wpChangePowerState 

wpE jectDisk 

wpLockDrive 

wpPower 
wpQueryAssociatedProgram 
woQueryAutoRefresh 
wpQueryDefStatusView 
wpQueryDriveLockStatus 
wpQueryPowerConfirmation 
wpQueryPowerManagement 
wpQueryRefreshRate 
wpSetAssociatedFilelcon 
wpSetAutoRefresh 
wpSetAutoRefresh 
wpSetDefStatusView 
wpSetPowerConfirmation 
wpSetPowerManagement 
wpSetRefreshRate 


SUMMARY 

OS/2 2.1 continues to build on the 
foundation established by OS/2 2.0, 
providing a solid base for running and 
developing applications for DOS, 
OS/2, and Windows. Strengths include 
new 32-bit interfaces and the object-ori- 
ented System Object Model. 
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“It doesn’t crash "| can’t reproduce it!" "Why does WinDefWindowProc 
in the debugger?’ generate an error? 
“Exactly, what ‘Where should I put ‘It must be a 
| did you do?" WinGetLastError?" configuration problem!" 
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- Notifies your window procedure or callback function - 
- Supports both PM and Fullscreen programs Includes a PM Viewer, 
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If you're running OS/2; you've probably discovered how much 
disk space your powerful new operating system demands. 

Not to worry. 

With Stacker” for OS/2 & DOS, you can quickly and safely 
double the capacity of your hard disk to take full advantage of 
OS/2's power. 

Using Stac” Electronics’ patented, award-winning Stacker LZS” 
technology, Stacker instantly and transparently compresses all your 
data, storing it more efficiently so you have more room to work. 

That’s all there is to it! You can install Stacker in minutes and 
access all your compressed files at any time, whether you boot 


from OS/2 or DOS. 


OW, DO YOU HAVE 
ENOUGH ROOM TO USE IT? 


And, with the Stacker Optimizer” you can quickly defragment 
your Stacker drives to get the best possible performance. Stacker 
works on disks as large as 1 gigabyte, giving you up to 2 gigabytes of 
disk capacity. And, it even comes with a simple Unstack command 
that returns your system to its original, uncompressed state. 

New Stacker for OS/2 & DOS. Think of it as adding space to 
your OS/2 workplace. 
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1-800-522-STAC, ext. 8207 
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0S/2 2.1 supports many popular CD-ROM drives and enhances application compatibility for DOS CD-ROM appli- 
cations. A layered CD-ROM device driver design illustrates how SCSI and non-SCSI attached CD-ROM drives are 


supported. BY FRANK SCHROEDER and RICK EFRUSS 


CD-ROM Support in OS/2 2.1 


[: popularity of CD-ROM drives has 
_ increased significantly in the past year and 
the trend is expected to continue. This 
increased popularity can be attributed to several 
factors—increasing numbers of CD-ROM software 
titles, the continuing evolution of multimedia, and 
the increased use of CD-ROM discs as a conve- 
nient storage medium for large quantities of data. 
Computer software manufacturers have increased 
their use of CD-ROM discs as a cost-effective 
means of distributing software products and tech- 
nical information to customers. 

With the growing popularity of CD-ROM, 
emphasis has been placed on enhancing CD-ROM 
support in OS/2. While in OS/2 2.0, CD-ROM 
support is limited in the number of drives sup- 
ported and the level of compatibility with DOS 
applications, OS/2 2.1 support has been enhanced. 
OS/2 now supports many popular CD-ROM dri- 
ves; the level of DOS CD-ROM application com- 
patibility has also been improved. 

This article describes the CD-ROM enhance- 
ments in OS/2 2.1. A layered CD-ROM device dri- 
ver model is described; topics ranging from DOS 
application compatibility to installation are pre- 
sented, and a list of supported CD-ROM drives is 
included. 


0S/2 2.0 
In OS/2 2.0, support for CD-ROM hardware and 
software is limited. The CD-ROM device driver 
(CDROM.SYS) supports only IBM and IBM-com- 
patible CD-ROM drives by Toshiba. Drives from 
other manufacturers are not supported. 

Users with unsupported CD-ROM drives can 
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work around this limitation with the OS/2 VM 
boot feature, accessed with the “DOS from Drive 
A:” icon in the Command Prompts folder. The VM 
boot feature allows the user to boot a native ver- 
sion of DOS in a full-screen session under OS/2. 
The booted DOS session uses the native DOS CD- 
ROM device driver that ships with the CD-ROM 
drive. Access to the CD-ROM drive is possible only 
through the booted DOS session; the drive cannot 
be accessed from an OS/2 or WIN-OS2 session. 
The virtual CD-ROM device driver 
(VCDROM.SYS) in OS/2 2.0 supports only some 


of the programming interfaces defined in the DOS aie Galdnaaoh 


CD-ROM Extensions (MSCDEX). Although many 
DOS CD-ROM applications work properly in OS/2 
2.0, those that use unsupported DOS CD-ROM 
extensions will fail. (The terms “DOS CD-ROM 
Extension” and “Microsoft CD-ROM Extension” 
[MSCDEX] are used interchangeably and refer to 
the same set of programming interfaces.) 


0S/2 2.1 

OS/2 2.1 offers more extensive support for CD- 
ROM drives and CD-ROM applications. Device 
driver support is provided for most of the popular 
SCSI-attached CD-ROM drives. Figure 1 shows a 
complete list of supported CD-ROM models. 

The CD-ROM device drivers in OS/2 2.1 fully 
exploit the capabilities of each CD-ROM drive. 
Data and audio support are provided for all mod- 
els. CD-ROM XA support is provided for those 
models that support the CD-ROM XA storage 
standard, which enables the interleaving of audio, 
video, and standard file system data. It is the stor- 
age format used in Kodak’s Photo CD technology, 
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Manufacturer Model 
Hitachi 


CDR-3650 
CDR-3750 


IBM CD-ROM I 


CD-ROM II 


NEC CDR-25 
CDR-36 
CDR-37 
CDR-38 
CDR-72 
CDR-73 
CDR-74 
CDR-74-1 
CDR-82 
CDR-83 
CDR-84 
CDR-84-1 


Panasonic CR-501 


LK-MC5015 


DRM-600 
DRM-604X 


Pioneer 


Sony CDU-541 
CDU-561 
CDU-6111 
CDU-6211 
CDU-7211 


Texel DM-3021 
DM-3024 
DM-5021 
DM-5024 
Toshiba XM-3201 
XM-3301 
XM-3401 


CDR-1650S 
CDR-1750S 





Interface 0S/2 CD-ROM Device Drivers 

SCSI-1 OS2CDROM.DMD HITCDS1.FLT 
SCSI-1 OS2CDROM.DMD HITCDS1.FLT 
SCSI-1 OS2CDROM.DMD HITCDS1.FLT 
SCSI-2 OS2CDROM.DMD 

SCSI-1 OS2CDROM.DMD TOSHCDS1.FLT 
SCSI-2 OS2CDROM.DMD 

SCSI-1 OS2CDROM.DMD NECCDS1.FLT 
SCSI-1 OS2CDROM.DMD NECCDS1.FLT 
SCSI-1 OS2CDROM.DMD NECCDS1.FLT 
SCSI-2 OS2CDROM.DMD 

SCSL-1 OS2CDROM.DMD NECCDS1.FLT 
SCSI-1 OS2CDROM.DMD NECCDS1.FLT 
SCSI-1 OS2CDROM.DMD NECCDS1.FLT 
SCSI-2 OS2CDROM.DMD 

SCSI-1 OS2CDROM.DMD NECCDS1.FLT 
SCSI-1 OS2CDROM.DMD NECCDS1.FLT 
SCSI-1 OS2CDROM.DMD NECCDS1.FLT 
SCSI-2 OS2CDROM.DMD 

SCSI-2 OS2CDROM.DMD 

SCSI-2 OS2CDROM.DMD 

SCSI-1 OS2CDROM.DMD 

SCSI-2 OS2CDROM.DMD 

SCSI-2 OS2CDROM.DMD 

SCSI-2 OS2CDROM.DMD 

SCSI-1 OS2CDROM.DMD SONYCDS1.FLT 
SCSI-2 OS2CDROM.DMD 

SCSI-2 OS2CDROM.DMD 

SCSI-1 OS2CDROM.DMD SONYCDS1.FLT 
SCSI-2 OS2CDROM.DMD 

SCSI-1 OS2CDROM.DMD SONYCDS1,.FLT 
SCSI-2 OS2CDROM.DMD 

SCSI-1 OS2CDROM.DMD TOSHCDS1.FLT 
SCSI-2 OS2CDROM.DMD 

SCSI-2 OS2CDROM.DMD 


Figure 1. CD-ROM drives supported by OS/2 2.1 


which stores photographic images on a 
CD-ROM disc. 

To increase DOS CD-ROM applica- 
tion compatibility, OS/2 supports the 
full set of application programming 
interfaces defined by Microsoft CD- 
ROM Extensions 2.21. A new DOS set- 
ting, INT_DURING_I0, allows faster perfor- 
mance of DOS multimedia applications. 

A layered CD-ROM device driver 
model simplifies device driver develop- 


ment for both SCSI and non-SCSI CD- 
ROM drives. Several CD-ROM manu- 
facturers use this model to develop 
OS/2 device drivers that support their 
popular non-SCSI CD-ROM drives. 

A system view of OS/2 2.1 CD- 
ROM components and their relation- 
ships is illustrated in Figure 2. The fol- 
lowing sections give an overview of the 
CD-ROM subsystem and the responsi- 
bilities of each component. 


The Virtual CD-ROM Device Driver. The 
virtual CD-ROM _ device driver 
(VCDROM.SYS) provides the compati- 
bility layer for DOS applications that 
require CD-ROM API services. It con- 
sists of two parts: a generic OS/2 virtu- 
al device driver (an operating system 
extension responsible for separating the 
activity of multiple DOS sessions) and 
a DOS device driver. The virtual device 
driver model consists of a dynamic link 
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library with separate instance data for 
each DOS session. 

The virtual device driver portion of 
VCDROM.SYS is responsible for servic- 
ing the DOS CD-ROM Extensions soft- 
ware interrupt (INT 2Fh) interface. DOS 
applications use the AH register for the 
DOS CD-ROM Extension function code 
(15h) and the AL register for the com- 
mand code, as shown in Figure 3. Para- 
meters to the DOS CD-ROM Extensions 
API are passed in the general-purpose 
registers. (This API is described in fur- 
ther detail in the CD-ROM Program- 
mer’s Guide for MS-DOS CD-ROM 
Extensions 2.21.) 

The DOS CD-ROM Extensions 
enable DOS applications to determine 
the number of CD-ROM drives 
installed; to navigate the volume, path, 
and directory structures; and to man- 
age the files stored on a CD-ROM disc. 
The virtual device driver routes the 
DOS CD-ROM Extensions request to 
the OS/2 CD-ROM file system. 

The DOS device-driver portion of 
VCDROM.SYS handles DOS INT 21h file 
system requests to the CD-ROM drive. 
All requests—for example, reading a 
file from a CD-ROM disc—are routed 
from the DOS device driver to the 
OS/2 CD-ROM file system. The virtual 
CD-ROM device driver passes requests 
to the OS/2 CD-ROM file system using 
the virtual device helper services. 

Additional information on the virtu- 
al CD-ROM device driver and the vir- 
tual device helper services can be 
found in the Virtual Device Driver Refer- 
ence of the OS/2 Technical Library. 


The CD-ROM File System. The OS/2 CD- 
ROM file system (CDFS.IFS) is a file 
system driver that understands how 
data is stored on the CD-ROM disc and 
uses the installable file system mecha- 
nism to attach to and receive requests 
from the OS/2 file system. The primary 
method of storage and retrieval, the 
High Sierra/ISO-9660 format, specifies 
precisely how volume-, directory-, 
path-, and file-specific information is 
arranged on the media. 

CDFS.IFS uses the file system helper 
services to pass data and audio com- 
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mands to the CD-ROM device manag- 
er. The helper services convert each 
requested operation into a device driver 
request packet that is passed to the CD- 
ROM device manager. For example, if 
CDFS.IFS receives a request to read data 
from a file, it converts the file-system 


File System API 


ves that comply with the American 
National Standards Institute (ANSI) 
SCSI-2 standard X3T9.2/86-109 (SCSI- 
2 draft of proposed ANSI Revision 
10g). It provides generic data and 
audio support for drives that support 
the command set specified in the 


Int 21h 


Virtual Device Helper AP! 


y File System Helper API 


| SCSI-2 Commands 


Vendor-Unique 
y SCSI-1 Commands 





Figure 2. OS/2 2.1 CD-ROM component hierarchy 


read request into the appropriate physi- 
cal sector read request, which is then 
processed by the device manager. 


The CD-ROM Device Manager. The 
OS/2 CD-ROM device manager 
(OS2-CDROM.DMD) is a generic 
block-device driver for CD-ROM dri- 
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standard. Vendor-unique CD-ROM 
XA support and multisession Kodak 
Photo CD support are provided for 
selected drive models. 

The CD-ROM device manager pro- 
vides a uniform interface between its 
clients and adapter device drivers. 
Clients of the device manager include: 
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OS/2 applications 

Multimedia Presentation 

Manager/2 (MMPM/2) 

applications 

¢ The virtual CD-ROM device 
driver 

* The CD-ROM installable file 

system. 


OS/2 applications and the MMPM/2 
subsystem communicate with the device 
manager using the OS/2 file system API 
and Categories 80 and 81 I0Ctl services, 
as shown in Figure 4. 

DOS applications communicate 
indirectly with the CD-ROM device 
manager, going through the virtual 
CD-ROM device driver. VCDROM.SYS 
converts DOS CD-ROM extensions and 
DOS file system requests into an OS/2 
file system (or category 80 or 81 IOCt1) 
request, which is then routed to the 
CD-ROM device manager using the 
virtual device helper services. 

The CD-ROM file system communi- 
cates with the CD-ROM device manag- 
er using the, request packet interface 
defined in the O'$/2.2.0) Physical Device 
Driver Reference ovanual, 

The interface between the device 
manager and adapter device drivers 
adheres to the adapter-device driver 
interface defined in the OS/2 2.0 Stor- 
age Device Driver Reference Manual spec- 
ification. The device manager converts 
a request from its client into a SCSI-2 
command descriptor block and routes 
the SCSI-2 command to the specified 
adapter device driver. 

The device manager is an installable 
block-device driver loaded with a 
DEVICE= statement in CONFIG.SYS. It 
replaces CDROM.SYS, the CD-ROM 
device driver shipped in OS/2 2.0. 


SCSI-2 Emulation Filters. A SCSI CD- 
ROM target device with vendor-unique 
commands not supported in the SCSI-2 
standard requires a SCSI-2 emulation 
filter (.FLT), as shown in Figure 1. The 
emulation filter maps SCSI-2 com- 
mands received from the device man- 
ager to the vendor-unique commands 
supported by the target device. This 
support is required to enable audio sup- 


Command Function Description 

00h Get number of CD-ROM drive letters 
Oth Get CD-ROM drive device list 

02h Get copyright file name 

03h Get abstract file name 

04h Get bibliographic file name 

06h Reserved 

07h Reserved 

08h Absolute disc read 

09h Absolute disc write 

Qah Reserved 

Obh CD-ROM drive check 

Och MSCDEX version 

Odh Get CD-ROM drive letters 

Oeh Get/set volume descriptor preference 
Ofh Get directory entry 

10h Send device request 

11h-OFFh Reserved 


Figure 3. MSCDEX Version 2.21 command codes and function descriptions 


port on CD-ROM drives that adhere to 
the SCSI-1 standard because the SCSI-1 
standard does not define a standard 
command set for audio control. 

A SCSI-2 emulation filter is required 
for each vendor-unique CD-ROM 
drive. Typically, a CD-ROM manufac- 
turer uses the same vendor-unique 
command set for all its CD-ROM dri- 
ves; one filter driver is therefore 
required for each manufacturer. 

The filter driver receives SCSI-2 com- 
mands from the CD-ROM device man- 
ager, converts the command to its ven- 
dor-unique equivalent, and routes the 
filtered command to the SCSI adapter 
device driver. If data returned with the 
command needs to be filtered, the filter 
driver regains control when the request 
is complete, converts the outgoing data 
to its SCSI-2 equivalent, and returns to 
the device manager. The filtering 
process is transparent to the device 
manager and the adapter device driver. 


SCSI Adapter Device Drivers. A SCSI 
adapter device driver (.ADD) contains 
the hardware-specific modules required 
to program the SCSI adapter that con- 


trols the CD-ROM drive. An OS/2 SCSI 
adapter device driver is needed to sup- 
port a SCSI-attached CD-ROM drive in 
OS/2. The generic INT 13 device driver 
(IBMINT13.113), which can be used to 
support a SCSI attached fixed disc, can- 
not be used to support a CD-ROM 
drive. 

The SCSI-2 emulation filter and the 
SCSI adapter device driver adhere to 
the adapter-device driver interface 
defined in the OS/2 2.0 Storage Device 
Driver Reference Manual. 

OS/2 2.1 comes with device drivers 
for SCSI adapters from IBM, Adaptec, 
DPT, and Future Domain. In addition, 
OS/2 device drivers for SCSI adapters 
from Always Technology, BusLogic, 
MediaVision, Mylex, Trantor, and 
UltraStor are available from either the 
manufacturer or third-party developers. 


Non-SCSI CD-ROM Adapter Device Drivers. 
Several leading CD-ROM drive manu- 
facturers use proprietary, non-SCSI, host 
adapter interfaces for CD-ROM drives. 
To support a non-SCSI CD-ROM drive, 
the adapter device driver must emulate 
a SCSI-2 target device. This enables the 
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Here’s a C Set offer with lots 
of pluses. From IBM Program- 
ming Systems. Because for only 
$149, you can upgrade from 

Work Set/2 or C Set/2 to the new 
C Set++™ the most complete object- 
oriented application package you can 
buy for OS/2° 

Its 32-bit C/C++ compiler 
lets you unleash all the power 
of OS/2 — giving you industrial 
strength code for your mission 
critical applications. 

It has an extraordinary code optimizer with a full 
set of options. Even a switch to optimize for the new 
Pentium™ processor. Plus a full set of class libraries, 
including application frame- 

works for PM, container classes 
and classes for multitasking, 
streams and more. 
Plus, there’s 
. an ee a full complement 
of other helpful 
features. Such as an interactive source level debugger. 

And the unique Execution Trace Analyzer traces the 
execution of a program, then graphically displays Optimization 
diagrams of the analysis. 

Plus, you get Workframe/2™ a language-independent 
tool that lets you customize your own environment. 
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To order your upgrade at the low price of only $149, 
contact your nearest dealer or call 
1-800-342-6672 (USA) or 
1-800-465-7999 ext. 461 (Canada). 
But hurry. This offer expires August 31, 1993. 
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IBM and OS/2 are registered trademarks and C Set++ and Workframe/2 are trademarks of International Business Machines Corporation. 
Pentium is a trademark of Intel Corporation. Windows is a trademark of Microsoft Corp. © 1993 IBM Corp. 








0S/2 

Category Function Category Function T0Ct1/Command Description 
02h 00h Ty Return address of device header 
02h Oih 80h 70h Return location of head 
02h 04h 8ih 60h Return audio channel information 
02h O6h 80h 60h Return device status 
02h 07h 80h 63h Return sector size 
02h 08h 80h 78h Return volume size 
02h 09h **#(8) Return changed media code 
02h Qah Sih 6ih Return audio disc information 
02h Obh 81h 62h Return audio track information 
02h Och 81h 63h Return audio subchannel Q information 
02h Oeh 80h 79h Return UPC code 
02h 15h 8ih 65h Return audio status information 
03h 00h 80h 44h Eject disc 
03h Oth 80h 46h Lock/unlock door 
03h 02h 80h 40h Reset drive 
03h 03h 8ih 40h Audio channel control 

(1) 80h 6ih Identify CD-ROM driver 

mini 80h 72h Read long ) 

**(3) 80h 50h Seek 

#4) Bih 50h Play audio 

(5) Sih Sih Stop audio 

(6) Sih 52h Resume audio 
Notes 


5. DOS extended device driver command 133h 

6. DOS extended device driver command 136h 

7. Command is not available in OS/2 2.1 

8. Corresponds to OS/2 block device driver command 01h 


1. Command is not available in DOS. 

2. DOS extended device driver command 130h 
3. DOS extended device driver command 131h 
4, DOS extended device driver command 132h 


Figure 4. DOS to OS/2 2.1 CD-ROM I0Ct1 mapping 


CD-ROM device manager to issue a 
common command set to its target 
devices, regardless of whether a target 
device directly supports the SCSI-2 com- 
mand set or the attached host adapter is 
SCSI or proprietary. The incoming com- 
mand and the return sense data must be 
emulated by the driver. 

Non-SCSI CD-ROM adapter device 
drivers adhere to the adapter-device 
driver interface defined in the OS/2 2.0 
Storage Device Driver Reference Manual 
specification. 


CD-ROM GENERIC IOCTLS 
OS/2 provides an API called device 


I/O control (DosDevI0Ct1), which enables 
applications to communicate directly 
with OS/2 device drivers. The OS/2 
INCtls are specified by a category code 
and a function code. For CD-ROM sup- 
port, the category 80h I0Ctls control 
data access to the drive, while category 
8ih IOCtls control audio features of the 
drive. These I0Ctls are routed from the 
application to the CD-ROM device 
manager. The CD-ROM I0Ctls are fur- 
ther described in the IBM PS/2 CD- 
ROM II Technical Reference manual. 
The DOS operating system provides 
an equivalent application programming 
interface called I/O Control (I0Ct1) so 


DOS applications can communicate 
directly with device drivers. The INT 21h 
function 44h call is translated by the DOS 
device driver portion of the virtual CD- 
ROM device driver to a virtual device 
helper, which is then routed to the CD- 
ROM device manager. Additional infor- 
mation about the DOS I0Ctl interface 
can be found in Appendix C of the DOS 
5.0 Technical Reference manual. 

The DOS I0Ctls are specified as 
belonging to either the read (02h) or 
write (03h) categories and are further 
subdivided into function codes, which 
correspond to the activity that the 
application is requesting of the device 
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“WE BUILT THREE VERSIONS OF OUR APPLICATION TO RUN ON EIGHT PLATFORMS. 
THERE’S NO WAY WE COULD HAVE GOT THAT PRODUCT OUT WITHOUT SOFTWARE 
CONFIGURATION MANAGEMENT. I’D use PVCS Even IF | DIDN’T WORK HERE. +s 


If you're facing an assignment as tough as Jim’s, 
you're ready for The PVCS Series. 


If your development team has more than one member, 


your application has more than one module or you're 
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j driver. Figure 4 illustrates the mapping 
of DOS CD-ROM I0Ctls to their corre- 
sponding OS/2 equivalents. 


INSTALLATION 

Installation of CD-ROM device drivers 
has been simplified in OS/2 2.1. Dur- 
ing the initial installation of OS/2, the 
installation program automatically 
detects the presence of the CD-ROM 
drive and SCSI adapter and installs the 
required device drivers. The product 
name of the detected CD-ROM drive 
and SCSI adapter is displayed, provid- 
ing visual feedback to the user. 

Users who add a CD-ROM drive to 
their system after OS/2 has been 
installed can use the Selective Install 
feature to install the required device 
drivers. 

After installation, the CONFIG.SYS 
file will contain the following state- 
ments: 


DEVICE=C: \0S2\MDOS\VCDROM.SYS 
IFS=C:\0S2\CDFS.IFS /Q 
BASEDEV=IBM2SCSI. ADD 
DEVICE=C:\0S2\0S2CDROM.DMD /Q 


In these statements, VCDROM.SYS repre- 
sents the virtual CD-ROM device dri- 
ver for DOS application support and 
CDFS.IFS represents the CD-ROM file 
system driver. IBM2SCSI.ADD is the 
adapter device driver for the IBM PS/2 
SCSI Adapter. (This statement varies 
depending on the SCSI adapter 
installed.) OS2CDROM.DMD is the OS/2 CD- 
ROM device manager. 

The adapter device driver is loaded 
with BASEDEV=, while the CD-ROM device 
manager is loaded with the DEVICE= 
statement. For CD-ROM drives that use 
the SCSI-1 interface, a BASEDEV= statement 
is also required to load the SCSI-2 emu- 
lation filter. (Figure 1 gives a complete 
list of supported CD-ROM drives and 
their associated device drivers.) 


DOS SETTINGS FOR CD-ROM 
APPLICATIONS 

In OS/2 2.0, one thread is used in each 
DOS session for all activity, including 
hardware interrupt simulation. This sin- 
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Figure 5. INT_DURING_I0 DOS setting 


gle-threaded implementation limits the 
performance of DOS multimedia appli- 
cations. The limitation is noticeable in 
DOS applications that require synchro- 
nized audio and video; the typical result 
is breakup of the audio or video stream. 
A breakup occurs when the single 
thread is blocked in the device driver 
while waiting for a read of the CD- 
ROM to complete. When blocked, the 
thread cannot process the simulated 
hardware interrupts of the other stream. 
OS/2 2.1 adds a new DOS setting, 
INT_DURING_10, which alleviates this syn- 
chronization problem, as shown in Fig- 
ure 5. When INT_DURING_IO is set to ON, 
OS/2 2.1 creates a second thread so 
that hardware interrupt simulation can 
occur concurrently with input and out- 
put. The result is smoother audio and 
video playback for DOS multimedia 
applications. Because the INT_DURING_I0 
DOS setting adds some overhead to the 
system, it should be activated only 
when needed to make a particular 
application run successfully. 


KODAK PHOTO-CD SUPPORT 

Kodak recently introduced its Photo CD 
technology, which enables users to store 
photographic images on a CD-ROM 





disc. To support the Photo CD stan- 
dard, a CD-ROM drive must be able to 
read CD-ROM XA formatted sectors. 

Multisession Photo CD allows users 
to add more sets of photographs to a 
CD containing an existing set. In OS/2, 
multisession Photo CD is supported for 
the following CD-ROM drives: 


¢ Sony CDU-561 

¢ Toshiba 3401 

* Texel 3024/5024 (with Texel 
Photo CD firmware upgrade) 

¢ Pioneer DRM-604X (with 
Pioneer Photo CD firmware 
upgrade). 


Single-session Photo CD restricts the 
storage of images to a single set; no pho- 
tos can be added after the initial set. Sin- 
gle-session Photo CD is supported in 
OS/2 2.1 for these CD-ROM drives: 


¢ CD Technology Porta-Drive 
T3301 

¢ Hitachi CDR-3750 

® IBM CD-ROM-II 

¢ Sony CDU-541, 6211, 7211 

© Texel 3024, 5024 

® Toshiba 3301 

¢ NEC Multispin 38, 74-1, 84-1. 
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How to help 









(noun) 


From the boardroom to the mail- 
room to the lunchroom to the wash- 
room, there may be more ways than 
you think to help your company be- 
come environmentally responsible: 


¢ Recycled office paper 
¢ In-house recycling programs 


e Reduced or recycled product 
packaging 

¢ Glassine or open window 
envelopes 


¢ Compact fluorescent light bulbs 
¢ Company coffee mugs 


¢ Weekly departmental newsletters 
instead of daily memos 


B.. how can you help your com- 
pany make these changes? Where 


Rick M. Efruss, /BM Personal Software 
Products Division, 1000 N.W. 51st St, Boca 
Raton, Fla. 33431. Efruss is the CD-ROM 
development lead in the OS/2 device dri- 
vers and multiple virtual DOS machines 
department. He has worked in OS/2 devel- 
opment since 1986. Efruss holds a B.S. 
from the University of Virginia and an M.S. 
from the Georgia Institute of Technology, 
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1. One who keeps the 


environment green. 2. A series of clip- 


and-save tips for keeping your business 
and home environments green. 


can you find energy-saving, recyc- 
lable, and recycled materials? How 
can your company recycle its own 
waste? And how can you do it at little 
or no expense—or even save money? 


Ty some of the suggestions in 
Keeping Your Company Green, written 
by Stefan Bechtel and the editors of 
Rodale Press. This how-to guidebook 
is packed with “simple, doable steps 
your company can take to help keep 
itself—and the world—green.” The 
book also includes a Directory of 
Green Products and Services. For 
more information, contact Rodale 
Press at 1-800-441-7761. 


Permission granted by Rodale Press, Inc. 


The Green-Keeper series is sponsored by 
the MFI Green Project of Miller Freeman Inc. 
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This article describes enhancements to printing performance in OS/2 2.1 with emphasis on the OS/2 LaserJet 
printer driver. We will compare and discuss new performance options in the LaserJet driver: printer memory 
usage, large buffers, printer hardware patterns, and HP-GL/2. BY SHIXIONG YANG and MONTE COPELAND 


Print Performance Options in 
OS/2 2.1 Printer Drivers 





Shixiong Yang 





Monte Copeland 


under OS/2 2.0: the addition of the 32-bit 

graphics engine component (PMGRE.DLL), 
advances in printer hardware, and changes to 16- 
bit OS/2 Presentation Manager (PM) print drivers. 
This article describes changes in OS/2 2.1 that 
affect printing, with special emphasis on the OS/2 
LaserJet printer driver. It compares new perfor- 
mance options in the LaserJet driver: printer mem- 
ory usage, large buffers, printer hardware pat- 
terns, and HP-GL/2. 


hree things affected printing performance 


CHANGES AFFECTING 
PRINTING PERFORMANCE 


32-Bit Graphics Engine Component. The OS/2 graphic 
engine component (PMGRE.DLL or simply GRE) 
has been converted to 32-bit in OS/2 2.1 and was 
first introduced in the Service Pak ( previously 
referred to as the corrective service disk) for OS/2 
2.0. 

The new GRE allows OS/2 to enable 32-bit PM 
device drivers while retaining compatibility with 
existing 16-bit PM device drivers. In OS/2 2.1, 
most PM video drivers are 32-bit, while most PM 
printer drivers are 16-bit. 

Because of this, printing takes some perfor- 
mance hits because of “thunking.” A thunking 
process is a short piece of code that allows 32-bit 
functions to call 16-bit worker routines and vice 
versa. The GRE uses thunks in OS/2 2.1 to retain 
compatibility with 16-bit PM printer drivers—but 
at a cost: executing thunk code takes additional 
time. For example, a commonly run test case caus- 


es the GRE to call the driver function FillPath over 
600,000 times for a single page. Each call must exe- 
cute thunk code. 

Most laser printers have 300 dots-per-inch (dpi) 
resolution, but new models boast 600 dpi. This 
twofold increase in resolution means a fourfold 
increase in raster data that the GRE, the printer 
drivers, and the OS/2 kernel must generate and 
send to the printer. To store a letter-sized mono- 
chrome bitmap at 300 dpi, for example, takes 
about 1MB of memory; at 600 dpi it takes about 
4MB of memory. 


New Performance Optimization. In OS/2 2.1, the 
GRE, spooler, and 16-bit PM printer drivers have 
been optimized to improve printing performance. 
In the past, the interaction between the GRE and 
PM printer drivers was not a problem since both 
GRE and drivers were 16-bit. Now, however, 
reducing the interaction becomes an important 
issue. To improve performance, we used dynamic 
GRE dispatch tables. We also found opportunities 
in the GRE, the spooler, and PM printer drivers to 
cache memory rather than freeing and reallocat- 
ing it later. In several cases, this improved spool- 
ing time by as much as 10% to 25%. 


Dynamic GRE Dispatch Tables. One new use of the 
GRE is for dynamic dispatch table support. The 
GRE dispatch table (essentially a jump table) is an 
array of function pointers that, by default, point 
to functions in the GRE. Device drivers change the 
table and point to functions within the driver, an 
activity known as “hooking the engine.” Previous- 
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Printer Compression Mode Testing 
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Figure 1. Printer compression mode 


ly, a device driver had only one chance 
to hook the engine. With dynamic dis- 
patch tables, however, a PM driver can 
now selectively unhook the GRE func- 
tions based on its initial settings (job 
properties, device context type, and so 
on) when a new printer device context 


is enabled. Reducing the number of 


hooked functions reduces the number 
of thunks to execute; thus, printing per- 
formance improves. 


PERFORMANCE OPTIONS IN THE 
PM PRINTER DRIVERS 

In the printer properties dialogue, the 
PM LaserJet driver offers printer mem- 
ory and printer page protection selec- 
tions. It also offers four different per- 
formance options in the job properties 
dialogue of the driver. The printer 
object presents both dialogues, while 
most applications present the job prop- 
erties dialogue before printing. 

If these options improve perfor- 
mance, it is logical to ask, why not 
enable them all the time? The answer 
is that some options may not improve 
performance every time; it depends on 


Output File Size Comparison 


2 


the application program and the con- 
tent of the print job. 


Printer Memory Selection and Compres- 
sion Mode. In OS /2 2.1, the LaserJet dri- 
ver needs to know exactly how much 
printer memory is available for com- 
pressing raster data. On the printer 
properties dialogue, specify the amount 
of memory installed in your printer 
and the page protection value. The 
memory amount should include stan- 
dard and expanded memory. If you are 
unsure about these values, print the 
self-test page from the printer and enter 
the values displayed there into the 
printer properties dialogue box. 

The amount of available printer 
memory affects how the LaserJet driver 
compresses raster data. PCL5-capable 
LaserJet printers allow several modes 
of data compression; the driver chooses 
the optimal mode of compression 
based on printer capabilities, available 
printer memory, and the nature of out- 
put data. 

The modes of raster data compres- 
sion are uncompressed (mode 0), run- 


BB Mode 0 (Non-Compression) 
1) Mode 1 (TIFF) 

MM Mode 3 (Delta Row) 

HB Mode 5 (Adaptive) 





length encoded (RLL mode 1), tagged 
image file format (TIFF mode 2), delta 
row compression (mode 3), empty row 
(mode 4), and adaptive mode compres- 
sion (mode 5). 

Mode 2 is the tagged-image file for- 
mat, or TIFF, a combination of mode 0 
(unencoded) and mode 1 (RLL encod- 
ed). The driver selects mode 2 encod- 
ing when there are repeated or similar 
bytes adjacent to one another in a sin- 
gle raster row. 

Mode 3, the delta row encoding 
method, identifies those bytes in a 
raster row that are different from corre- 
sponding bytes in the preceding row. 
The driver transmits only those bytes 
that are different, then selects mode 3 
encoding when there are similar adja- 
cent raster rows. 

Mode 5, adaptive compression 
mode, is a mixture of all compression 
modes that can print empty or dupli- 
cate rows. In mode 5, the driver selects 
one compression mode per row but 
bundles up to 32K of rows into a single 
mode 5 block. Currently, only Hewlett 
Packard’s LaserJet 4 printers support 
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| this mode. 


The first step in choosing an optimal 
compression mode is to check the 
printer model and available memory. 
The driver studies the raster data and 


Fast System Fonts Option. In OS/2 2.0 and 
2.1, there is a fast system fonts option on 
LaserJet and IBM 4019 printer drivers. 
When the option is disabled, OS/2 sys- 
tem fonts are sent to the printer as raster 
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Figure 3. Printer patterns option testing 


chooses a suitable compression mode. 
The best selection is the one that con- 
serves the most spool file space and the 
time it takes to transmit data to the 
printer. Figure 1 shows the different 
spool file sizes of one page of raster 
data in two applications using different 
compression modes. The diagram 
shows that compression mode can have 
a large impact on file size and that the 
optimum compression mode varies 
with different output data. 


I Printer pattems on 
9 Raster mode (Compression on) 
[J Raster mode (Non-Compression) 





graphics data. When the option is 
enabled, however, the printer driver 
downloads OS/2 system fonts to the 
printer where they become (essentially) 
device fonts. With a large text job (for 
example, a multipage spreadsheet) 
designed with OS/2 system fonts, print- 
ing speed is dramatically improved. 


Large Buffers Option. This option refers 
to buffers of memory allocated from 
primary computer storage. When 
selected, it causes the PM LaserJet 


printer driver to allocate substantially 
more RAM when using the LaserJet 4 
or other 600-dpi printers. Test results 
show that this option works best with 
at least 8MB of RAM. 

With normal buffers, the LaserJet 
printer driver allocates a 1MB memory 
buffer to hold raster data for a letter- 
sized page. (The printable area for let- 
ter size is 8.0-by-10.6 inches. At 300 dpi, 
it takes 11,250 bytes per square inch to 
hold monochrome raster data. Thus, a 
300-dpi letter-sized page fits in 954,000 
bytes.) 

In higher resolutions or for forms 
larger than letter size, 1MB is not 
enough to hold all raster data. In this 
case, the driver uses a technique called 
“banding” to partition a page into sev- 
eral 1MB sections, or bands. Graphic 
orders are first recorded into a journal 
file, which is played as many times as 
necessary to write the raster data into 
each band. Using a 1MB buffer, print- 
ing to a LaserJet 4 printer at 600 dpi, 
the driver must generate four bands for 
a letter-sized page. The driver must 
play the journal file four times to ren- 
der the whole page. Replaying the jour- 
nal file is time-consuming; printing 
with it can take up to four times longer 
than printing a 300-dpi page. 

The large buffers option increases 
the size of the banding buffer to 4MB. 
A buffer of this size is adequate for a 
600 dpi letter-sized page; the driver 
need play the journal file only once. 
While this option may adversely affect 
a low-memory system, it provides a 
performance boost for users with 
enough system memory. Figure 2 
shows test results for the large buffers 
option on computers with varying 
amounts of system memory. 


Printer Patterns Option. This performance 
option was added in OS/2 2.1 for Laser- 
Jet and IBM 4019 printer drivers, to 
speed spreadsheet applications that fill 
rectangular areas with shading or cross- 
hatch patterns. It uses pattern-fill capa- 
bilities in the printer hardware instead 
of raster patterns generated by the GRE, 
reducing the size of the spool file and 
saving transmission time to the printer. 
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When the printer patterns option is 
enabled, the printer driver hooks the 
GRE function FillPath. When the GRE 
calls the printer driver to fill a path, it 
generates the appropriate PCL4 or 
PCLS printer control language com- 
mands for the target printer. PCL5 
printers support the HP print model 
and allow pattern filling with back- 
ground mixing modes. This hardware 
support is adequate for almost all pat- 
tern-filling graphic requirements. 

e performance gain with the 
printer patterns option depends on two 
factors. First, the complexity of paths or 
regions to fill affects performance. For a 
small number of large rectangular fills, 
the option greatly reduces the size of 
the output file and increases the print- 
ing speed. For a large number of rec- 
tan fills, however, it may overbur- 
den the printer’s engine and decrease 
performance. Our tests show that this 
option improves performance when the 
areas to fill are of moderate complexity. 
Figure 3 shows the test results printing 
an Excel for OS/2 spreadsheet with 
pattern fills of 28 rectangular areas. 

Second, the printer processor speed 
and printer language level affects per- 
formance. For PCL4 printers, the option 
should only be used for simple pattern 

(no overlay or white filling). Fur- 
ther, since the pattern-filling com- 
ah are executed in the printer, 

speed increase depends on the 
ea of the printer microprocessor. 


HP-GL/2 Option. HP-GL/2 is the stan- 
dardized version of the Hewlett- 
Packard Graphic Language usually 
found in the company’s line of plotters. 
HP-GL/2 is especially well suited for 
drawing arcs and lines because the dri- 
ver can efficiently generate vector 
drawing orders. Using HP-GL/2 com- 
mands reduces the output file size, 
increasing printing speed. When the 
HP-GL/2 option is enabled, the Laser- 
Jet print driver hooks the GRE func- 
for line, polyline, arc, box, area 

fill, box fill, and polygon fill. 
HP-GL/2 mode is best suited for 
print jobs that are mostly vector and 
pattern-fill commands with few raster 
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operations. For example, printing a line 
drawing test case to a LaserJet 4 printer 
with mode 5 compression produces a 
136K spool file without HP-GL/2; the 
same test case with HP-GL/2 enabled 
produces a 4K spool file. Figures 4 and 
5 show the performance of HP-GL/2 in 


with HP-GL/2. At an OS/2 command 
prompt, change directory (CD) to the 
\SPOOL\<physical name> and do a directory 
listing (OIR) of *.SPL with the /0D (sort by 
date) switch. The last two files contain 
the PCL5 commands generated by the 
driver. If the latter (HP-GL/2 enabled) 
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Figure 4. HP-GL/2 performance: printing time comparison 
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Figure 5. HP-GL/2 performance: output file size comparison 


three test cases for arc drawing, line 
drawing, and pattern filling. 

To tell if a job is suited for HP-GL/2, 
first specify printer-specific format in 
the LaserJet settings for queue options, 
then change the status to hold. Print the 
job two times, first without and then 


1993 


trial is substantially smaller than the 
former, then the job is well suited for 
HP-GL/2. 

There are some limitations to the 
HP-GL/2 option. Mixing HP-GL/2 
drawing and raster drawing can lead to 
incorrect output if one should overlay 
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controlled by mouse-driven “drag and drop.” 
Built-in list boxes, check boxes, radio 

buttons, type fonts and other graphical tools 

allow you to create attractive GUIs that are so 


intuitive, they're a snap for even the most 
unsophisticated end users. 


POWERFUL REPORTING FEATURES 


PM/FOCUS offers the most powerful reporting 


language of any product on the market today. 


And building reports is a breeze. You simply 


O82 is.a registered trademark of Intemational Business Machines Corp. PM/"POOLS is a registered trademark of Information Builders, Inc, 1250 Broadway, NY, NY 10001 


transform database fields, record selections, and 
report headings and footers into selectable 
objects. Even complex sorts are available at the 
touch of your mouse. 


DELIVER GREAT OS/2 GUls 
Get the promise of OS/2 now. Make PM/FOCUS 
your corporate standard for sensational GUI 
application development. For more information, 
or to attend a free seminar... 


Call 800-969-INFO 
In Canada call 416-364-2760 


TRI PmM/Focus 
ZED Ifformation Builders, Inc. 








the other. The order in which they are 
drawn can affect the final result. 

Patterns are treated differently 
when HP-GL/2 is enabled; the driver 
essentially ignores the setting of the 
printer pattern’s performance option in 
this case. When HP-GL/2 is on, the dri- 
ver will always fill areas using HP- 
GL/2 commands. 

Font output may also differ slightly 
with HP-GL/2; character strings ren- 
dered with it may differ from strings 
rendered with system fonts, especially 
when text is clipped, rotated, or mixed 
with other graphics such as lines or 
patterns. 

Depending on job content, output 
rendered with HP-GL/2 can differ 
from the non-HP-GL/2 path. If so, turn 
off the HP-GL/2 option. 


FUTURE DIRECTIONS 

New advances in bidirectional ports 
and printers will eventually enable dri- 
vers to query the printer for installed 
memory and fonts, simplifying driver 
configuration and saving unnecessary 
work. We expect more application pro- 
grams to subclass the Workplace Shell 
printer object and provide drag-and- 
drop printing for their particular file 
formats. 

Our strategy is to move away from 
the 16-bit PM printer drivers and 
exploit the 32-bit model. The 32-bit 
print drivers and the GRE will interop- 
erate using the flat memory model. The 
absence of thunking combined with the 
new performance techniques described 
here promise even faster printing on 
the horizon. 
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As enterprises begin to roll out applications on client/server platforms such as OS/2, system administrators 
must manage large numbers of distributed resources such as clients, shared printers, and file servers. This 
presents an opportunity for developers of distributed system management applications. BY CHUCK MCKELLEY 


LAN NetView: 
A Programming Overview 
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lient/server architecture is characterized 

by applications executing on a large num- 

ber of workstations and PCs rather than on 
one time-shared mainframe or minicomputer, In 
addition to performing traditional network man- 
agement, the administrator of a client/server net- 
work must deal with such problems as distribut- 
ing corrective service disks and new releases of 
software products to LAN-connected clients and 
servers, performing remote failure analysis, and 
monitoring remote system use. A few vendors 
have delivered distributed applications that help 


_ administrators solve these and other problems. 


Most of these distributed system management 
applications consist of two major pieces. The sec- 
tion of an application that contains the user inter- 
face is often known as a manager or managing 
program, while the PC upon which it runs is 
called a managing station. Most distributed man- 
agement programs also contain an agent, a pro- 
gram that runs on the systems to be managed. The 
systems on which the agent runs are called man- 
aged stations. 

Management protocols, which managers use to 
communicate with agents, run over a variety of 
transport protocols, such as the transmission control 
protocol/internet protocol (TCP/IP) and the Net- 
BIOS protocol. Many management applications use 
private management protocols; some, however, use 
either the simple network management protocol 
(SNMP), originally designed to manage TCP/IP net- 
works, or the common management information 
protocol (CMIP), designed to manage open systems 
interconnection (OSI) networks. SNMP and CMIP 


are quite different and, until recently, most distrib- 
uted system management application vendors have 
had to choose between the two. In addition, most 
vendors concentrate on only a few parts of the dis- 
tributed system management problem, with the 
result that different system management applica- 
tions are incompatible and have very different user 
interfaces. Further, an application that manages 
SNMP agents may not be able to communicate with 
CMIP agents and vice versa. 


LAN NETVIEW 

With the announcement of the LAN NetView dis- 
tributed management products (based on Hewlett- 
Packard’s OpenView technology), IBM has made 
it easier for vendors to integrate distributed man- 
agement applications on an open-system, stan- 
dards-based framework with a single object-ori- 
ented user interface similar to that of the Work- 
place Shell. The NetView family supports 
managing stations on OS/2 and managed stations 
on OS/2, DOS, and DOS plus Microsoft Windows 
platforms. The NetView open systems API allows 
the managing station to communicate with SNMP 
and CMIP agents on a variety of IBM and non- 
IBM platforms. 

The LAN NetView family, shown in Figure 1, 
contains products upon which distributed system 
management applications can be built. The base 
product set includes a product for managing sta- 
tions, LAN NetView Manage, and three for man- 
aged stations: LAN NetView Enabler, LAN 
NetView Agents for DOS, and LAN NetView 
Agents Extended. 
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Managing Station 








Figure 1. The LAN NetView family 


MANAGING STATION COMPONENTS 

LAN NetView Manage is installed on OS/2 
managing stations. It contains core APIs and ser- 
vices that allow managing applications to commu- 
nicate with CMIP and SNMP agents on managed 
stations throughout the network. Manage uses 
TCP/IP to communicate with SNMP agents. For 
CMIP ivan it supports CMIP over TCP/IP 





(CMOT) and CMIP over logical link control 
(CMOL). Manage also contains several compo- 
nents that assist applications with distributed 
management. 

Event Management Services (EMS) collects 
CMIP events and SNMP traps issued by agents on 
remote systems and routes them to any application 
registered to receive them. EMS’s filter service 
allows applications to register only for events and 
traps ere to them. In addition, an EMS agent 
logs events and retrieves event data from the log. 
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‘Managed Station 





The Metadata Service manages the NetView 
management information base (MIB). Agent devel- 
opers can use the service to store their managed 
object definitions in the MIB, where they are avail- 
able for use by application programs. Applications 
can retrieve object definitions to understand 
objects that have been added by another applica- 
tion or agent developer. 

The Topology Management Service (TMS) con- 
tains a set of discovery functions that explore the 
network and collect information about network 
nodes and links. TMS stores the information in a 
network topology database available to manage- 
ment applications. The collected data includes sta- 
tus information, which is constantly updated to 
reflect the network state. TMS can discover SNMP 
and CMIP objects accessed via TCP/IP as well as 
CMIP objects accessed via CMOL. 

Application integration and user interface func- 
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tions are supplied by the View compo- 
nent, the user’s port into the network 
topology. An object-oriented user inter- 
face much like the OS/2 Workplace 
Shell, the View component was built 
using object-oriented programming 
techniques and the OS/2 system object 
model (SOM). There are two levels of 
integration available. Management 


applications can be launched from the 
topology display by registering an .EXE 
file with the View component's appli- 
cation integration service. An applica- 
tion can also be tightly coupled with 
the user interface and can use object- 
oriented programming to access topol- 
ogy information and user interface 
folder data. When a user selects an 
object in the View folders, the appro- 
priate SOM class is called. 


MANAGED STATION 
COMPONENTS AND PRODUCTS 
LAN NetView Manage also includes 
agents for the LAN Server 3.0 requester 
and OS/2 2.0 with the service pack and 
2.1. These agents can be used to man- 
age the LAN Server requester and 
operating system on the managing sta- 
tion. For example, the OS/2 agent can 
retrieve information about the operat- 
ing system, set information in the 
CONFIG.SYS file, and emit notifica- 
tions when exception conditions are 
detected. Manage also contains a per- 
formance subagent that retrieves select- 
ed performance information. 

The managed station counterpart to 
Manage is LAN NetView Enabler, 
which contains the subset of the LAN 
NetView Manage function needed to 
allow agents on OS/2-managed sta- 


tions to receive and respond to requests 
from the managing station. The Enabler 
includes the same OS/2 and LAN Serv- 
er requester agents packaged with 
Manage. 

CMOL agents to manage worksta- 
tions running DOS 5.0 or DOS 5.0 with 
Microsoft Windows 3.1 are provided 
by LAN NetView Agents for DOS. 


An application can also be tightly coupled 
with the user interface and can use object- 
oriented programming to access topology 
information and user interface folder data. 


These DOS and Windows agents are 
installed on managed stations. 

LAN NetView Agents Extended pro- 
vides agents for OS/2 Extended Services 
1.0 Database Manager, OS/2 LAN Serv- 
er 3,0, and Communications Manager/2 
1.0. The database manager agent 
exploits the administration APIs of the 
OS/2 Extended Services 1.0 Database 
Manager and the OS/2 Database Dis- 
tributed Connection Services/2 1.0 on 
OS/2. Applications can use this agent to 
update database configuration informa- 
tion, catalogue nodes, or perform any 
other administrative task for which the 
database manager provides an API. The 
LAN Server agent allows management 
applications to perform remote adminis- 
tration on IBM LAN Server 3.0 
requesters and servers on OS/2, with 
the Communication Manager/2 1.0 
agent doing the same for Communica- 
tion Manager/2 1.0. 


LAN NETVIEW 

MANAGEMENT PROTOCOLS 

LAN NetView-based management 
applications and agents communicate 
via the X/Open OSI Abstract Data 
Manipulation API (XOM) and the 
X/Open Management Protocols API 
(XMP). The open-system XOM and 
XMP APIs are symmetric; the same API 


is used on the managing and managed 
stations. XOM allows applications and 
agents on various platforms to encap- 
sulate management data and requests 
in self-describing packets that can be 
decoded by any XOM-knowledgeable 
receiver. Where analogous operations 
exist, XMP permits applications to 
communicate consistently with CMIP 
and SNMP agents. While optimal per- 
formance is achieved with specific 
commands for CMIP and SNMP 
agents, the LAN NetView Manage and 
LAN NetView Enabler implementa- 
tions of XMP can map between CMIP 
and SNMP requests, hiding the multi- 
ple management protocols from the 
application. 

In addition to the management 
framework and agents, the LAN 
NetView family includes four manage- 
ment applications: a fault monitor, a 
performance monitor, a configuration 
manager, and a manager that transmits 
LAN notifications to and receives com- 
mand functions from a mainframe 
NetView host. 


CONCLUSION 

The LAN NetView family provides 
developers of management applica- 
tions and agents with a robust stan- 
dards-based framework on which to 
build distributed management applica- 
tions. The framework’s support of mul- 
tiple management and transport proto- 
cols allows developers to concentrate 
on management applications rather 
than the mechanics of communication, 
The X/Open APIs combined with the 
LAN NetView management services 
provide a standard way to supply 
agents, one that allows applications to 
manage resources consistently. Devel- 
opers can share objects and integrate 
applications with the LAN NetView 
topology display. 


Charles R. McKelley, Jr., /B/\/ LAN Sys- 
tems, 11400 Burnet Rd., Austin, Texas 
78758. McKelley is an advisory programmer 
on the LAN NetView vendor support team. 
In his 26 years with IBM. he has held vari- 
ous technical and management positions in 
field support and software develapment. 
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05/2 Monthly's Book of the Year! 
New edition of a best seller! 
CLIENT/SERVER | ar 
PROGRAMMING | cos, 
WITH OS/2° 2.0 } 

Second Edition " 
By Robert Orfali and 

Daniel Harkey 

Readers raved about the first edition of this best selling 
Client /Server-OS/2 resource. Now updated with in- 
depth tutorials and sample code, this is the ideal guide 
to client/server in the 32-bit environment. Covers all 
new 2.0 functions. 

$39.95, 1,026 pages, paper, 0-442-10219-5 
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New! Power up with the experts! 


USING 
WORKPLACE 
OS/2° 


Power User’s Guide to 
IBM’s New Operating 
System/2 Version 2.1 
By Lori T. Brown and Jeff Howard 
Get the “inside” help of the’ Workplace Shell's lead 
designers to * convert easily.and quickly from 
Windows and Mac environments! to OS \i2 © set up, 
maintain, and customize youn omm: Waekplace envi- 
ronment * power up with Q3/2"s Multimedia 
Presentation Manager/2 under Workplace. 
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New! 

OS/2°® 2.X NOTEBOOK 
The Best of OS/2°® 
Developer Magazine 
Edited by Dick Conklin 

Foreword by Philippe Kahn, 
Borland International, Inc. 

The very best articles from OS/2 
Developer Magazine, completely 
revised! Includes product reviews, 
coding examples, user tips and 
techniques. Over 1,100 pages cover- 
ing software tools, graphical user 
interface, client/server and object 
oriented programming, multimedia 
and graphics and lots more. 

$34.95, 1,164 pages, paper, 

200 illustrations, 0-442-01522-4 


$24.95, 400 pages, paper with disk, 0-442-01590-9 


New! 

THE OS/2® 2.1 
CORPORATE PROGRAM- 
MER’S HANDBOOK 

By Nora Scholin, Martin Sullivan, 
and Robin Scragg 

Simplify migration from DOS and 
Windows to OS/2 2.0 and find 
valuable solutions based on modu- 
lar subdesigns, from function key 
assignments to pull-down menus. 
$39.95, 352 pages, cloth, 
0-442-01598-4 


LOOK FOR THESE OS/2° 2.0 LIBRARY BOOKS 


from VAN NOSTRAND REINHOLD 
at major technical bookstores nationwide. 


EASY ORDERING! CALL TOLL-FREE: 1-800-544-0550. 


Or Fax 1-606-525-7778 


WRITING OS/2® 2.0 
DEVICE DRIVERS IN C 

by Steven J. Mastrianni 

The first guide to programming 
32-bit OS/2 device drivers includes 
C source code examples, with 
optional disk. Reduces the difficulty 
and cost of writing device drivers 
for OS/2. 

$36.95, 410 pages, paper with 
optional disk, 0-442-01141-5 





VAN NOSTRAND REINHOLD 
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Accessing and analyzing data in a variety of ways is critical in a business environment. The IBM Personal Appli- 
cation System/2 Version 3 is IBM's new 32-bit client/server product for decision support applications within the 
Information Warehouse framework architecture. BY RON DOUGLAS, SHAUN JONES, and WILLIAM KING, JR. 


32-bit GUI Client/Server 
Application Development 
With Personal AS/2 





Shaun Jones 





William King, Jr. 





ersonal Application System/2 Version 3 
(Personal AS/2 V3), developed by IBM's 
Programming Systems (PRGS) division, is a 
32-bit application designed for data access, query, 
data analysis, presentation, and communication of 
business results. It contains a range of tools to man- 
age and format data, including: 





Table edit and browsing 

Query 

Data analysis and manipulation 
Report writing 

Chart creation 

Task automation via iconic procedures. 


Personal AS/2 V3 is designed for business 


Number of Outstanding Orders 


Total Value of Orders 


Contact Telephone Number | (713)-134-7777 





Figure 1. Custom window created with Builder/2 
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users and takes advantadge of OS/2 2.1 Work- 
place Shell functions such as drag and drop, clip- 
board support, and dynamic data exchange 
(DDE). 


PERSONAL AS/2 V3 PACKAGING 

The minimum configuration of Personal AS/2 V3 
is the base product, which provides data access, 
reporting and charting functions, and a graphical 
procedure function for generating basic applica- 
tions. The base product also provides run-time 
support for user applications developed with the 
optional Builder/2. Both products can be installed 
on a stand-alone PS/2 or LAN. Personal AS and 
related products are also available on the DOS 
Windows platform. 
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BUILD YOUR OWN 
OS/2 LIBRARY 


Reprints are now available for OS/2 DEVELOPER. 





| Use your customized reprints for: Customer support, sales 
tools, marketing support, educational tool. 





Call today for a custom quote: Laura Pullen, OS/2 DEVELOPER | 
415-358-0126 ext.302 or fax 415-358-9749 






Attention Mathematica users: 
Everything you need to know to get the most out 
of your math programming is in 


THE MATHEMATICA JOURNAL 





Call or fax today for information about 
subscriptions and special issues: 
Phone orders: 415-905-2332 

Fax orders: 415-905-2233 





NEURAL NETWORK 
SPECIAL REPORT 


Your comprehensive guide to neural network tools and 
the companies that make them - all new for 1992! 


All for only $7.95. 


To order, call 415-905-2376, or fax to 415-905-2233 now 





‘| Windows, Macintosh and UNIX. 


OCR for OS/2 


The most accurate and fastest Optical Character 
Recognition (OCR) software engine on the market today. 











OCR Library and API Toolkits available for OS/2, MS 


Cognitive Technology Corp. 
Larkspur, CA 
Ph. (415) 925-2323 Fax (415) 461-4010 












tcp/ip for OS/2 
“TCP/2™ is, by far, the best implementation 
of the tcp/ip application suite for DOS and 
OS/2 available from any source” 

Microsoft ITIS 
Essex Systems, Inc. 
One Central Street Phone (508) 750-6200 
Middleton, MA 01949 Fax (508) 750-4699 


Custom Entryfields allow formatting for fields like Phone Number, 
Dates, Social Security Number, Drivers License, ett. 


Easy to use. Just change the window class in your resource file. 
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SUBSCRIBE TODAY! 










Only $39.95 for a full year subscrip- 
tion to the premier source of tools and 
techniques for the OS/2 software 

developer: OS/2 DEVELOPER 


Call today and don't miss a single issue: 


1-800-WANT-OS2 





Gary Slattery, Software Developer, Computer Associates 


“The best platform for 
DOS and Windows.” 


“| develop software applications for a living 
and | think OS/2* is a great way to do 
business.” A 32-bit, virtual memory operat- 
ing system, OS/2 is the ideal platform for 
developing your DOS, OS/2, Windows™ and 
even host-based applications. 

With OS/2 you can boost the power of 
your favorite DOS and Windows tools, 


IBM and OS/? are registered trademarks and Workplace Shell, C++, CommonvView, 

C Set/2 and OS/2 Crash Protection are trademarks of International Business Machines 
Corporation. All other products are trademarks or registered trademarks of their respective 
companies. ©1993 IBM Corp 


“No more 








plus take advantage of over 250 available 
OS/2 development tools and utilities. 


“Its a productivity thing.” 

“I use CA Realizer to prototype new 
graphical interfaces. | write code using 
CA C++" and CommonView”™ (integrated 
with IBM’s C Set/2™ compiler) 
while | compile in the 
background. And when 
designing reports or 
planning schedules, 
I use CA-RET.” 

OS/2’s pre-emptive 
multithreaded multitasking dynami- 
cally manages CPU time so you can run 
DOS, Windows and OS/2 apps 
concurrently in different sessions 
with maximum efficiency. That 
means you can edit in one win- 
dow, compile in another, link in a 
third and test in a fourth. With OS/2 Urash 
Protection,’ if one application goes down 
due to a bug, the rest youre working on 
wont. “Theres no limit to what you can do 
with this system.... It's definitely made me 
more productive.” 











The Development Platform of Choice 

* Enhanced development platform for DOS, Windows and 
OS/2 apps. 

¢ OS/2 Crash Protection for superior reliability. 

* Pre-emptive multitasking for increased productivity, 

* Virtual memory provides up to 512MB per session. 


* Flat memory model eliminates wrestling with segments. 


* Multiple virtual DOS machines for concurrent app 
testing. 


. Object-oriented Workplace Shell is easy and intuitive. 





The object-oriented 
user interface—the Workplace. 
Shell™ (WPS)—gives you easy control with 
direct manipulation of visual objects on 

your computer screen. And should you need 
assistance with anything, IBM’s Worldwide 
Developer Assistance Program is always there 


to help. 
“A developers dream.” 
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Use OS/2 to increase productivity of DOS, Windows and 
OS/2 application development. 





With OS/2’s 32-bit architecture, you can 
push your 386 and 486 hardware to the limit, 


and develop spectacular multimedia yi 82 
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applications. OS/2 lets you create 
the widest range of applications, 
for a variety of platforms, for 
almost any size computer. Here’s 
your chance to develop truly 
revolutionary 32-bit applications. With 
OS/2, now there's nothing stopping you. 

To learn more, call 1 407 982-6408 
now, and get a free white paper on why OS/2 
is the ideal platform for your 
development efforts. 


PERATING SYSTEMS AND 

OfTWARE STANDARDS 
O82, Version 2.0 
IBM Corporation 
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Personal Application System 
Builder/2 
Personal AS/2 V3’s vendor-indepen- 
dent messaging interface allows inte- 
gration with office systems, enabling 
files and data to be sent to IBM and 
non-IBM e-mail applications. This 
capability can be extended with the 
optional Personal Application System 
Builder/2 (Builder/2). Personal AS/2 
V3’s features can also be integrated into 
applications launched directly from the 
Workplace Shell. 


The Personal AS/2 V3 
base product provides 
data access, reporting 
and charting of functions, 
and a graphical procedure 
function for generating 
basic applications. 


Builder/2 functions that help users 
who develop customized solutions for 
others include: 


e ASL, an event-driven develop- 
ment language 

¢ Full SQL access to the OS/2 
client/server database 

¢ Access to distributed relational 
data via Distributed Data Con- 
nection Services /2 (DDCS/2) 

¢ Support of DDE as client and 
server 

¢ An interface that allows e-mail 
capability 

¢ Editors for window layout and 
control placement 

e An intelligent program editor 

for rapid logic creation 

A C language interface 

OS/2 clipboard support 

An interactive debug facility 

APIs to objects such as Report 

and Chart. 


SSS ee ee ee ee ee 
Source program : Untitled 


Make File > DEMOCALC. WIN 
Date : 7=3-92 
Owner : System generated code 
Source window Designated object name 
DEMOCALC. WIN W_DEMOCALC 
ON SELECT 


This block is executed whenever a selectable control or menu 
entry is activated. 


ON SELECT 
D0 


CASE A.System. 0b ject ! Which screen object? 


WHEN "T.W_DEMOCALC.Multiply" ! Menu entry "Multiply" 
DO 

| Insert your code here 
END 


WHEN "T.W_DEMOCALC.Divide" § ! Menu entry "Divide" 
DO 

! Insert your code here 
END 


WHEN "T.W_DEMOCALC. Add" ! Menu entry "Add" 
DO 

! Insert your code here 
END 


WHEN "T.W_DEMOCALC.Subtract" ! Menu entry "Subtract" 
D0 

! Insert your code here 
END 


WHEN "T.W_DEMOCALC.STD_PUSH" 


DO 
CASE A.System.BoxNumber 
WHEN 1 ! Standard pushbutton "Calculate" 
DO 
! Insert your code here 
END 
WHEN 2 ! Standard pushbutton "Clear" 


Figure 2. Example of system-generated ASL code (continued on page 5/) 


such as C. It combines customization 
with business tools via its APIs and 
DDE linkages, providing prototyping 


Builder/2 can be viewed as an 
application development tool with a 
faster learning curve than languages 
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Program Selected Edit 





Source library; none 
Figure 3. Personal AS/2 V3 ASL editor 


and application development features 
that can adapt and extend the base 
product to meet specific requirements. 


PROVEN PRODUCT FOR 
MULTINATIONAL BUSINESSES 
Personal AS/2 V3 is the third version 
of the Personal AS product line, first 
introduced in 1989. The product is used 
in a variety of industries—retail, bank- 
ing and finance, health, public sector, 
and petrochemical. 

In addition to English, Personal 
AS/2 V3 is available in six languages: 
Dutch, French, German, Italian, Span- 
ish, and Japanese (DBCS). This avail- 
ability makes it useful for multinational 


JULY/AUGUST 


2 Example of system-generated ASL code (continued from page 56) 


Bal TTDEMO4.PRG - Program 


Library Help 


businesses seeking a single data analy- 
sis product for the enterprise. 


DATA ACCESS: STRENGTHS 
The strength of Personal AS/2 V3 lies 







data at an enterprise, departmental, or | 


personal level in several ways: 


¢ Exploitation of IBM’s Distrib- 
uted Relational Database Archi- 
tecture (DRDA) 

¢ Support of Information Builders’ 
Enterprise Data Access 
(EDA/SQL) technology 

e Links to AS/400 via PC 
Support and DDCS/2 

¢ The Application System S/390 
Intelligent Server 

¢ Its own relational-like table 
structures 

¢ Native ability to read and write 
data formats including ASCII, 
DIF, IXF, and DBF. 


A decision support component of 
IBM’s Information Warehouse frame- 
work architecture, the product directly 
accesses data stored in the OS/2 Data- 
base Manager or the newer IBM Data- 
base 2 OS/2 (DB2/2) product. In con- 
junction with IBM’s Distributed Data 
Connection Services/2 (DDCS/2), Per- 
sonal AS/2 V3 also provides seamless 
access to distributed relational data locat- 
ed on remote server databases such as 
OS/400, SQL/DS, and DB2. 


USING BUILDER/2 TO DEVELOP 
32-BIT GUI APPLICATIONS 
Although Personal AS/2 V3 can be 
used as packaged, the most successful 
installations are those in which its func- 
tions are launched from a customized 
application developed with Builder/2. 
The custom Presentation Manager GUI 
window shown in Figure 1, for exam- 
ple, was created with Builder /2. 

The control of such windows is 





Personal AS/2 V3 provides access to 
relational and nonrelational data at an 
enterprise, departmental, or personal level. 


in its built-in data access; it provides 
access to relational and nonrelational 
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managed by Personal AS/2’s Applica- 
tion System Language (ASL), automati- 
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Table 1. Attributes of the DDECLIENT ASL object that can be queried by an ASL application 


Table 2. Discrete events associated with the DDECLIENT ASL client 


Table 3. Actions that control the function of the ASL DDECLIENT object 
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Client/Server 
Database Solutions 


It’s available now—ready to per- 
form on your desktop. A new 
function-rich, 32-bit relational 
database you can really trust 
with your growing client/server 
network, your mission-critical 
data and your business. 
Introducing IBM DATABASE 2™ OS/2° 
(DB2/2™) from IBM Programming Systems, the 
birthplace of relational database technology. 
__DB2/2 includes an industrial-strength DB 
engine that supports transaction management, 
concurrency control, security, integrity, and 


DISTRIBUTED DATABASE 
CONNECTION SERVICES/2> 









recovery functions. Designed to exploit the from DB2} SQL/DS* and OS/400° 
power and open architecture of OS/2, it also databases as if they were on your desktop, too. 
supports industry-standard SQL for developing This versatility can play a significant role in 
portable applications. And it runs your DOS, an Information Warehouse™ solution 
DOS Windows™ and OS/2 for your business. 
applications requiring We've developed an 
online access. 

You can access data 
directly from DB2/2 on | 
your desktop or froma = | 
DB2/2 server on your | ad 





LAN, and with 
| exciting demo diskette to show 

you just how well new DB2/2 

performs—right on your desktop. Call us today 

for your free demo, or to order DB2/2: 

1 800 342-6672; or fax: 1 800 445-2426, 

In Canada, call 1 800 465-7999, ext. 850. 

An upgrade from IBM Extended Edition 

or Extended Services is also available. 





*Manufacturer’s suggested retail price is $425. 


IBM, OS/2, DB2 and OS/400 are registered trademarks and DATABASE 2, DB2/2, DISTRIBUTED DATABASE CONNECTION SERVICES/2, = —_— < 
SQL/DS. and information Warehouse are trademarks of International Business Machines Corporation. Windows is a trademark of = = = oo 
Microsoft Corporation. © 1993 IBM Corp. ——_—_—— - = 








Template for the ON TARGET block. This event is signalled when there 
has been Direct Manipulation between this application and some other 
application. This applications Source window has had an Icon dropped 
onto it from some other application. This application can now ask 
questions to find out what’s been dropped, and take action. 


ON TARGET ( 
pStream) 
00 
DECLARE POINTER pStream 
CASE 
WHEN (?pStream) “FORMAT = "Link" 
DO 
DEFINE LinkData[0] 
LET X00 = BINARY(0,1) 


Figure 4, ASL DDE extentions (continued on page 62) 
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Looking for fast answers 
to your development questions? 





Time is money when you connect to 
CompuServe, and Golden CommPass 
saves you both. It jets you compose 
your questions off-line. send them in 

ad flash and disconnect. It gets your 
replies while you're busy program- 
ming. It's a native OS/2 app, with all 
the power and features you'd expect. 


You need to do two things: 

Go on-line with CompuServe 
Information Service. Use Golden 
CommPass to do it. 
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CompuServe hosts OS/2 developer 
and user forums monitored by 

technical personnel. IBM devel- 
opers are there with responses 
to anything that’s got you 
stuck. Other OS/2 pro- 
grammers and enthu- 
siasts are there, too, 
comparing notes and 
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Get the fastest access to 

answers. Golden CommPass 
keeps your development 
schedule on course. The 

fact is, the sooner you start 
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giving feedback. It's using Our program, the sooner 
definitely the place to be. they'll be talking about yours! HE 
Phone: ‘eo | _ CompuServe: : 
(609) 234-1500 | Won @) (@ (eat 71514, 151 : 
race, (eles 3 
Fax: | ‘Ge b; ee; §=90 Day Satisfaction §& 
| (609) 234-1920 COMME aSdS | Guarantee 
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cally generated by Builder/2 when the 
window is created. ASL is an event-dri- 
ven object-oriented language. The sys- 
tem-generated code that determines 
which window a user has selected is 
shown in Figure 2. 

A key feature of ASL is its combina- 
tion of object-based language and event 
handling. It includes a built-in file sys- 
tem; vector handling; and mathemati- 
cal, string, and graphics facilities. ASL 
is object-based, with objects that can be 
used for tasks from handling complex 
windows to accessing SQL databases, 
DDE, and reporting and charting func- 
tions. Execution control is provided by 
a set of discrete events (such as START, 
SELECT, and QUIT) that can be detected by 
the language for specific processing. 

Builder/2 features designed to 
improve programmer productivity 
include a window editor with built-in 
palettes for selecting standard PM con- 
trols, a full-function ASL editor, an ASL 
compiler, and a make facility. The editor, 
shown in Figure 3, has been redesigned 
for Personal AS/2 Version 3. 

ASL extensions are provided to sup- 
port access to the OS/2 relational data 
manager (DB2/2), DDE, emulator high- 
level language application program- 
ming interface (EHLLAPI), and tight 
coupling with C and REXX. 

In Figure 4, ASL extensions for sup- 
port of DDE automatically link a Per- 
sonal AS/2 application with an OS/2 
2.1 spreadsheet that has been dropped 
onto the application’s source window 
for processing. (In this example, Per- 
sonal AS/2 V3 functions as a DDE 
client). 

Five attributes of the DDECLIENT ASL 
object can be queried by an ASL appli- 
cation; these are shown in Table 1. Five 
discrete events, shown in Table 2, are 
associated with the DDECLIENT ASL client. 
Finally, Table 3 lists nine actions that 
control the function of the ASL DDECLIENT 
object. 

Personal AS/2 V3 can also function 
as a DDE server where a Personal AS/2 
V3 object, such as a report or chart, is 
linked to another OS/2 2.1 object, such 
as a word processing document. The 
attributes, discrete events, actions, and 


Our Fax/PM Applet* 
made OS/2 fax aware... 
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she/y — Fax/PM uses the advanced OS/2 rt . 
Py features (drag & drop...), turning your L ani 
= computer into a sophisticated fax 
~% <> machine. 

YU x Fax/PM enables you to send, receive 


and print faxes in background mode. 


Supports Group III fax modems 
(Class | & 2). 

s) All internal laptop modems and 
~ specific fax boards. 
Standard fax speed (9600 bps) and 
high speed (14400 bps). 





Under OS/2: to fax... just print... 
Without leaving your favorite DOS, 
Windows or OS/2 applications, 
Fax/PM makes faxing easy for you. 
All fonts supported, for a 
"Laser-printed" quality fax. 
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OS/2 standalone, LAN or 
Client-Server, as well as Windows, 
DOS and AS/400 versions: 

there is a Fax/PM configuration to 
suit your needs. 


_ Fax/PM provides APIs for fax 
integration in custom applications. 
These APIs can be called by any 
programming language or 

REXX procedure. 


Fax without leaving your AS/400. 
Fax/PM AS/400 provides seamless 
integration for AS/400 and 

PC users. 

Fax from Office Vision/400, 
spooled files... 
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events for the DDE Server ASL object 
| are similar to those listed for the DDE 
Client ASL object. 


PERFORMING EVENTS 

AT SET TIMES 

Builder/2 “timers” allow events to occur 
at predetermined times or after specific 
time intervals. Timers can be used, for 
example, to schedule a middle-of-the- 
night data manipulation, automatically 
route output to a waiting printer or plot- 
ter, or initiate an ASL/EHLLAPI pro- 
gram (like the one described in the previ- 
ous section) for automated processing 
with the $/390 server. 

Figure 5 shows a sample Personal 
AS/2 V3 timer application developed 
with Builder/?, in which a user can 
specify the date and time a predefined 
Personal AS/2 V3 procedure, report, or 
chart is to be executed. 

These automatically triggered events 
allow users to perform regular tasks 
using the latest corporate data, such as 
producing a weekly sales report or a 
chart of the most active customer 
accounts for a month without human 
intervention. This level of automation is 
made possible by Personal AS/2 V3’s 
support for APIs into REPORT and CHART 
objects called from an ASL program. 
Figure 6 shows an API call to the CHART 
object. The type and style of the chart, 
as well as the X and Y data variables to 
be used, can be determined under 
direct ASL program control. 


USING PERSONAL AS/2 V3 IN 
BUSINESS 

Personal AS/2 V3 is designed to access 
enterprise data from the OS/2 desktop; 
its level of integration with the OS/2 
Database Manager, DB2/2 and DRDA 
make it a strong prototyping tool for 
new client/server applications. With 
Builder/2, prototype applications and 
their CUA 91-compliant windows, 
applications can be generated in a frac- 
tion of the time required to manually 
code them. In one business application, 
for example, Personal AS/2 V3 is being 
used in joint application development 
projects in which users develop the 
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CALL (?pStream) ‘GETDATA(LinkData[0]) 
CALL (?pStream) “FINISHED() 

SHUT ?pStream 

LET Application = WORDS(LinkData[1], 1, X00) 
LET Topic = WORDS(LinkData[1], 2, X00) 
LET Item = WORDS(LinkData[i], 3, X00) 
CALL DDECLient( 

Application, 

Topic, 

Item) 


END 
OTHERWISE 
DO 


DEFINE ServerData[0] 
CALL (?pStream) “GETLINE(ServerData[0]) 
DO i = 1:ServerData[0] “ENTRIES 
STAMP LENGTH(ServerData[i]) 
END 
CALL (?pStream) “FINISHED() 
SHUT ?pStream 


SHUT  ServerDisp 

DEFINE $D_ColForm[0] 

INSERT SD_ColForm[0] = "WIDTH="~ 
MAX((64LENGTH(ServerData)) ,Group’SIZEX - 15) 
DEFINE SD_ColData[0] 

INSERT SD_ColData[0] = ServerData[0] 


OPEN LIST ServerDisp, Window, 
XK = Group*X + 5, 
Y = Group’Y + 5, 
SIZEX = Group’SIZEX - 10, 
SIZEY = Group’SIZEY - 15, 
SELECTION = 1, 
HORZSCROLL = 1, 
EXPRESSION = SD_ColForm[0], 
COLDATA = §$D_ColData[0] 
END 
END 


END 


PROCEDURE DDEClient( 
Application, 
Topic, 
Item) 


Figure 4, ASL DDE extentions (continued on page 63) 
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Figure 5. Sample Personal AS/2 V3 timer application 








DO 
STAMP Application 
STAMP Topic 
STAMP Item 
SHUT  DDECLient 
OPEN ODECLIENT DDECLient, 
APPLICATION = Application, 
TOPIC = Topic, 
TRACE = DDETrace 
LET  Text°TEXT = STRING( 
"DDECLIENT OPENed for Application: , Topic: ", 
Application, Topic) 


CALL DDECLient “SYSTEM(SysItems[0], "SysItems") 
LET  Request“ENABLED = 0 
LET  Advise’ENABLED =0 
LET  Execute’ENABLED = 1 
END 





Figure 4. ASL DDE extentions (continued from page 62) 
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To use Chart API - CHARTAPI.PGM - ADC 1992 
ON START 
D0 

!Find out where Base is installed 

LET Basepath=5.Control.Path 


1 


Set the variables that vill be used later 


For OPEN IBMCHART 
LET ChartType="Bar" 


For SelectTable 
LET filename=Basepath| |"\SAMPLES\EMPDATA" 
LET filesystem="PAS" 


For X SetAxisType 
LET xaxistype="Character" 


For SelDatak 
LET xcolumn="Division" 


For Y SetAxisType 
LET yaxistype="Numeric" 


For SelAnalysis 

LET Column="AnnualSalary" 
LET Function="Avg" 

LET Display="Abs" 


OPEN IBMCHART Mychart, 

Name = "", INo current name 
Identifier = Basepath||"\Chart", !Name of template 
Type = ChartType, IChart Type 
Perspective = 1, 120 = 0, 3=1 


Rotated = 1, Rotated = 1 or 0 
AutoRefresh = 0, 'AutoRefresh = 1 or 0 
SavePrompt = 0, !Prompt = 1 or 0 
Dialog = 1, 'Display dialogs ? 


EUIMode = "Restricted" 'Full or Restricted 


Reset any existing input table 
CALL Mychart“RESETDATA() 


Figure 6. Calling a CHART API from ASL 
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Establishing the X and Y data before the input table 
is defined prevents the Select columns dialog from 
appearing automatically. 


Set X axis type, variable set above 
CALL MyChart“SetAxisType( 
ay" : 


xaxistype) 


Set X column, variable set above 
CALL MyChart*SelDatax( 
xcolumn) 


Set Y axis type, variable set above 
CALL Mychart“SetAxisType( 

nye 

yaxistype) 


Set analysis for Y scale, variables set above 
CALL MyChart‘SelAnalysis( 

Column, 

Function, 

Display) 


Choose the table, variables set above 
CALL MyChart “SelectTable( 

filename, 

filesystem) 


Finally open the Chart 
CALL MyChartOPEN() 


END 


ON QUIT 


STOP PROGRAM 


S/fzZ BEVELGOPRPER 


prototype windows themselves using 
Builder /2. 
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Distributed Application/2 (DA/2) can help program client/server or interprocess communication in OS/2 2.0 
or higher. DA/2 provides a simple set of APIs that allows communication between programs running on OS/2 
systems in a network. BY ED VAN VLIET, STEVE WASLESKI, RICK BLEVINS, and ANDREI MALACINSKI 


Client/Server Programming 
with Distributed Application/2 





Wasleski, Rick Blevins, and Ed Van Vliet 


nyone who has written networked 
client/server applications knows it is diffi- 
cult to choose and use a specific communi- 
cation protocol. “Which protocol do I need to code 
and test my application? If I 
choose protocol X,” developers 
ask, “will it be available in all the 
networks I support?” 

These and many other questions 
y= must be answered while designing 
|| | and building a client/server appli- 
|) @ )) cation. Once you have chosen a pro- 
tocol, you must become sufficiently 
proficient to handle most cases that 
arise. Communication protocols can 
be difficult to learn. Most programmers must 
endure a steep learning curve before becoming 





& 


ski, Steve 


Even after a given protocol is 


mastered 


user requirements 


could change the underlying 
communications code. 


familiar with the nuances of a given communication 
protocol. Even after a given protocol is mastered, 
user requirements could change the network being 
used, with resulting changes to the underlying com- 


munications code of an application. 


DISTRIBUTED APPLICATION/2 

Distributed Application/2 (DA/2) is a layer placed 
above communication protocols that provides a 
simple, consistent way to program interprocess and 
network communication into a client/server appli- 
cation under OS/2 2.0 or higher. Figure 1 shows an 
overview of the DA/2 structure, 

DA/2 is designed to hide the complexity of its 
supported communications protocols, allowing 
you to select a communications protocol at run 
time without changing code and to program in 
either C or REXX. DA/2 supports the following 


communication protocols: 


e Auvanced program-to-program 
communication (APPC) 

* NetBIOS for IBM or Novell LAN 
configurations 

¢ OS/2 named pipes. 


System requirements for DA/2 are OS/2 2.0 or 
later, IMB of disk space, and 0.5MB of memory 
above OS/2. 


THE FOUR BASIC INTERFACES 

The DA/2 interface is composed of seven APIs. 
Four APIs support data transfer via DAOpen, DACLose, 
DARead, and DAWrite. The APIs provide a full duplex 
path between the client and the server, adding 
flexibility to program design. These four APIs are 
described in Table 1. 
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Figure 2 shows a simple conversation between 
a client and server. The client opens the conver- 
sation, writes data, then calls DARead to wait for 
data. In Figure 3, the server accepts the conversa- 
tion with a call to DAOpen, reads the data sent by 
the client, then writes additional data to the 
client. 


MULTIPLE CLIENT SUPPORT 

Three event APIs, described in Table 2, are available 
to simplify handling multiple conversations. These 
APIs are especially useful within a server applica- 
tion that supports several clients concurrently. 

The DAWaitOnEvent API reports either an incoming 
conversation request or an incoming data event to 
the caller, allowing you to specify specific event 
types. For an incoming conversation to be report- 
ed, the connection name for the conversation must 
have been identified on a prior call to DAIdentif yRe- 
source. Events of each type are queued in FIFO 
order, with conversation requests having a higher 
priority than data events. Data events for all con- 
versations are reported by DAWaitOnEvent, regardless 
of whether the current process is the initiator or 
acceptor of the conversation. 

A call to DAWaitOnEvent reports the arrival of data 
or a pending conversation; to actually receive the 
data, a DARead call is necessary. To start the pending 
conversation, the ACCEPT option must be chosen in 
the DAOpen API. 

Figure 4 shows a complete REXX server (minus 
error checking) that supports multiple concurrent 
clients. This server can be used with the REXX 
client example in Figure 2. 


ADVANTAGES OF DA/2 


e Ease of use—Each language binding in 
DA/2 was designed to accommodate the 
programming style of that language. 
Option parameters are character strings for 
REXX and UNSIGNED LONG for C. 


¢ Run-time protocol selection—The application 
is not bound to a specific communication 
protocol when it is built. Rather, the proto- 
col is chosen with the DA/2 connection 
profile editor just before the application is 
run. 


¢ Single workstation development—Client/ 
server applications can be built and tested 
in a single machine without APPC or Net- 
BIOS installed. 


NATIVE APPC APPLICATION 
COMMUNICATION 

In addition to transparently supporting named 
pipes, NetBIOS, and APPC when both partners 
use DA/2, DA/2 provides a method to talk to 
native APPC applications. 


Figure 1. DA/2 approach to communications programming 


Table 1. Data movement APIs 


You can choose native APPC support by select- 
ing either the “Native APPC—Confirmation” or 
“Native APPC—No Confirmation” radio buttons 
on the second APPC page of the Connection Pro- 
file Editor notebook. 

Unlike with normal DA/2 support, when using 
the native APPC support it is necessary to be aware 
if a partner is using APPC. In this case, the connec- 
tion is no longer full duplex, and some APPC half- 
duplex state considerations arise. 

Considerations are made for APPC confirma- 
tion processing by providing an option for DAWrite 
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and status information for DARead. eS ESSE EEE 


Regular DA/2 and native APPC | /* — Sample REXX Client */ 
connections can appear in the same Name = "SAMPLCON" /* Connection name +/ 
program. DA/2 event APIs can also be 
used with native APPC support. For __/ {oad external functions, load variables into variable pool. _+/ 


PEN ES ere ee ee call rxfuncadd “DALoadFuncs’, “epfdarex”, “DALoadFuncs* 
nals data events from any one of a com- ’ ’ 





bination of regular DA/2 and native "= DALoadFuncs() /* load all other DA/2 functions */ 
APPC connections. rc = DALoadVars() /* load DA/2 return code values */ 
SUPPORT FOR THE IMS 

Hf trans /* Open a connection to the server. */ 
S Gaky cs * rc = DAQpen(handle, Name, “DA_INIT’, "FeedBack") /* Pass in name */ 

upport for native APPC applications %) | 

also enables a DA /2 client to communi- /* get back handle */ 
cate with an Information Management 

System (IMS) transaction. To invoke /* Writing data to the server. +/ 
synchronous IMS transactions, use a Options = “DA_WRITE_DATA* /* initialize options +/ 
simple DAOpen, DAWrite, DARead, and DACLose Respid = 0 /* initialize response id */ 


sequence. 
To invoke asynchronous IMS trans- 

actions, use DAOpen, DAWrite, and DACLose. 

The asynchronous reply will return via | "¢ = DAWrite(handle, Buffer, Options, "Respid”, "FeedBack") 

the IMSASYNC transaction program on 

your workstation. You can write the /* Read 100 bytes +/ 

IMSASYNC transaction using DAQpen, DARead, rc = DARead(handle, "buff", 100, “DA_WAIT’, "Respid", "bytesread", , 

and DAClose. As before, other regular "data". "conn", FeedBack.) 

DA/2 and native APPC connections , , 

can be active in the same program, and 

the DA/2 event APIs can be used. /* Close the connection. +/ 

rc = DAClose(handle, FeedBack.) 


Buffer = ‘This is the data written to server (can be any length)’ 


THE CONNECTION 

PROFILE EDITOR 

DA/2 keeps run-time connection 
information in connection profiles, 
which are stored in a binary file that Figure 2. A sample DA/2 REXX client 
must be located in a directory listed on 
the DPATH of any system that uses 
DA/2. Profiles can also be shared on a 
LAN drive. 

DA/2 supplies a configuration tool 
called the Connection Profile Editor to 
create and maintain connection profiles. 
This editor, like most, accepts as an 
optional parameter the name of a file 
containing connection profiles. During 
DA/2 installation, a program object is 
created with an association that lets users 
double-click on a *.CP file to start the edi- 


exit 





tor. The editor is shown in Figure 5. Table 2. Event notification APIs 
The editor uses the CUA 1991 user 
interface architecture, including the tion profiles. With each setting, you can Once in the editor, you can select a 


drag-and-drop technique, to facilitate access online help by pressing the Fl _ profile to edit, double-clicking on it to 
editing and management of the connec- key when focus is on the desired field. bring up a settings notebook for the 
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specified profiles. The first page of the 
/* Sample REXX Server +/ settings notebook contains general 

information about the connection, [0 
Name = "SAMPLCON" /* Connection name */ including the name of the connection 
and the protocol to be used. Each of the 
notebook pages that follow is devoted 
to information specific to the protocol 
selected. Editor settings are shown in 





/* Load external functions, load variables into variable pool. +/ 


call rxfuncadd “DALoadFuncs’, “epfdarex®, “DALoadFuncs’ 


rc = DALoadFuncs() /* load all other DA/2 functions */ Figure 6 
rc = DALoadVars() /* load DA/2 return code values +/ The second page is: ised to.add 
5+ le =e , named pipes and NetBIOS connection 

f ction client. + 

heel uo a ale J information and to specify whether the 
rc = DAOpen(handle, Name, “DA_ACCEPT’, "“FeedBack") /* Pass name +/ server is queued or nonqueued. If 
| nonqueued” is selected, a new server 
/* Read data from the client. */ is started each time a connection is 
opened. If you select “queued,” the 
Respid = 0 connection is made to an already run- 
| ning server; in this case, a new server is 
rc= DARead(handle, "buff", 100, ‘DA_WAIT’, "Respid", "bytesread",, started only if a queued server is not 


already running. 


Figure 3. A sample DA/2 REXX server (continued on page 70) The third and fourth notebook 


How are you going to test your client/server apps? 
Check one: 


_ | Manually 


__ | Partially 
——, The Softbrid 


Automated Test Facility 


It's not a trick question, but testing client/ Only the Softbridge Automated Test Facility 
server applications can be a tricky business. (ATF) is designed to cover all aspects of 
Traditional, manual methods can't stand up to client/server testing — GUI, distributed 

the complexities of client/server. And most systems, legacy applications. If you're doing 
automated testing tools provide only a partial client/server development, maybe it's time 
answer — concentrating on the GUI desktop, you checked out ATF. To find out how ATF 
and leaving the rest of the client/server testing can help with your client/server testing needs, 
puzzle for you to piece together. call 1-800-955-9190. 


o The Softbridge rae 125 CambridgePark Dr. 
= Automated Test Facility 617-576-2557 (Phone) 


617-864-7747 (FAX) 





. pages are devoted to APPC-specific SS SSS SSS SSS ee ae 





information. This includes configura- "data", "conn", FeedBac. ) 
tion information for APPC, such as the + a 
remote transaction program name, | /* Writing data to the client. */ 


mode name, local logical unit (LU) 
name, partner LU name, and other pro- 
file information specific to an APPC 
connection such as data conversion and 
whether your partner is using DA/2 eval : CALS e & - 
APIs or native APPC. rc = DAWrite(handle, Buffer, Options, "Respid", "FeedBack") 

With the Connection Profile Editor, 
you can manage multiple connection 
profiles using drag-and-drop. An rc = DiClose(handle, FeedBack.) 
administrator may want to maintain a Galt | 
master file of connection profiles to dis- 
tribute as needed. 


Options = “DA_WRITE_DATA’ 
Buffer = “This is data to write to the Client.’ 


/* Close the connection. +/ 


Figure 3. A sample DA/2 REXX server (continued from page 69) 


/* REXX Server supporting multiple clients sample. */ 
Name = "SAMPLCON" /* Connection name */ 


/* Load external functions, load variables into variable pool. */ 
call rxfuncadd “DALoadFuncs*, “epfdarex’, “DALoadFuncs’ 

rc = DALoadFuncs() /* load all other DA/2 functions */ 
rc = DALoadVars() /* load DA/2 return code values */ 


rc = DAIdentifyResource( Name, "FeedBack"); 


do FOREVER 
rc = DAWaitOnEvent( "outName", "outHandle", “DA_ALL_EVENTS’, "“eventType", , 
"“dataLength", “responseID", "FeedBack"); 
if rc = 0 then 
do 
if eventType = “DA_CONNECTION’ then /* open the incoming conversation */ 
do 
rc = DAOpen("handle", outName, “DA_ACCEPT’, "FeedBack"); 
end 


else if eventType = “DA_DATA” then /* handle the incoming data event */ 
do 
responselD = 0 
rc = DARead(outHandle, "buff", dataLength, “DA_WAIT’, "responseID", , 
"bytesRead", "dataStatus", "connStatus", "FeedBack"); 
if connStatus = “DA_CLOSE” then 
do 
rc = DAClose(outHandle, "FeedBack"); 
end 
else do 
/* ...process the data just read and send back a reply */ 
rc = DAWrite(outHandle, buff, “DA_WRITE_DATA”, "responseID", , 
"FeedBack"); 
end 
end /* end if eventType = “DA_DATA’ */ 
end /* end if rc = 0 */ 
end /* end do FOREVER loop */ 


Figure 4. Multiple client server 
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CONCLUSION 

DA/2 provides the communications 
needed for writing client/server appli- 
cations in most OS/2 environments. 
Full duplex paths are provided for 
APPC, IBM and Novell NetBIOS, and 
OS/2 named pipes. 
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As client/server computing becomes widely used, corporations and developers must handle their client/server 
needs. This article explains Easel Workbench and explores its advantages for corporate developers. 


BY CHRIS BROOKINS 


Easel Workbench: Robust 


Client/Server Development 


lient/server computing has been emerg- 

ing in the computer industry for the last 

several years, but it is only in the past year 
or so that the idea of client/server has caught on 
within the ranks of corporate developers. Informa- 
tion systems organizations see client/server as 
their way of exploiting the computing power and 
information resources of their enterprise. But 
increasing application needs, combined with 
steadily more complex computing environments, 
has led to a bewildering array of implementation 
options associated with client/server. 


CLIENT/SERVER FRAMEWORK 


Defining Client/Server. Client/server technology is 
a form of computing that divides application func- 
tion among networked computing resources, some 
of which are PCs or workstations commonly hav- 
ing a graphical interface. Within this definition 
there exist five forms or models of client/server 
computing, shown in Figure 1: 


e Database-server 

e¢ Transaction-server 

¢ Peer-distributed 

¢ Presentation-distributed 
* Presentation and logic 


Database Server. For applications that need to access 
data from a variety of back-end data sources, there 
is the database-server model of client/server. In this 
model, SQL is simply embedded in the client appli- 
cation and sent to the database server for process- 
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ing. Since the interface between the client and the 
server is strictly SQL-based, processing on the server 
is limited to what SQL can perform. Often, results 
are returned and processed further at the client. 


Transaction Server. Applications such as order entry, 
process control, and other mission-critical online 
transaction processing applications require consis- 
tent, minimal response times. The transaction- 
server model is optimal for OLTP requirements 
because it allows processing to be distributed and 
balanced between the client and the server. Data- 
intensive operations can take place at the server 
while user intensive tasks can be handled at the 
client. In addition, this model eliminates unneces- 
sary network traffic, since only the request and the 
final result are sent between client and server. 
Data processing that can’t be accomplished with 
SQL, such as conditional logic or complex aggre- 
gate functions, is performed on the server, elimi- 
nating the need for data to be sent over the net- 
work for client processing. 

A transaction is a single logical unit of work 
that may be as simple as an SQL statement or as 
complex as a combination of SQL statements, pro- 
cessing logic, and non-SQL data manipulation. 
The client initiates transactions such as UpdateSys- 
temBalances by name, hiding the underlying com- 
plexity from client developers and allowing trans- 
actions to be maintained independently of client 
applications. 


Peer. The peer model contains all the benefits of the 
transaction-server model with the added flexibility 
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Figure 2. [ransaction server mode! 


that at any time the client and server 


a5 can switch roles. This model is useful 
4 when an application must respond to 


unforeseen external events. For exam- 
ple, in a process monitoring system, a 
stockbroker application can request 
stock price information from the host 
server or the host server can send unso- 
licited data to the desktop if the stock 
price reaches a specified threshold. 


Distributed Presentation And Logic. Existing 
host-based legacy systems have become 
easier to use with the advent of PC- 
based graphical user interfaces, which 
brought about this form of client/server 
computing. The pure distributed pre- 
sentation model can improve usability 
by simply remapping existing host 


Figure 1. Client/server models 


Client 


Transaction 


request 


screens into equivalent graphical inter- 
faces with pulldown menus, entry 
fields, and other dialogue controls. 
Host-based applications in which codes 
must be entered, selection lists are not 
available, or the screens are difficult to 
understand become more user-friendly. 

It is possible to transform existing 
host-based systems into new systems 
that leverage the PC’s power by adopt- 
ing the distributed presentation and 
logic model. In this model, a new sys- 
tem is developed that utilizes existing 
services presented by the host system. 
Processing logic at the PC can off-load 
host processing or introduce complete- 
ly new functionality such as image, 
sound, or voice. This approach borrows 
from the database server model in that 
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the host application is fixed and prede- 
fined, although here the interface is 
through an existing path of host screen- 
to-screen navigation. Since application 
logic is split and executed between the 
server and the client, this model also 
contains some benefits of the transac- 
tion-server model, shown in Figure 2. 


Hybrid Applications. Corporate data infra- 
structures do not change overnight, nor 
do existing systems. A hybrid approach 
allows a developer to combine more 
than one client/server model in an 
application to meet the real needs of a 
business. For example, the goal may be 
to move the entire system to a Database 
Manager-based solution over time, but 
it is too time-consuming and expensive 
to reengineer everything at once. A 
hybrid application in this case would 
communicate with the existing system 
through distributed presentation sup- 
port, as well as add new application 
components on the LAN that are 
accessed through transaction server 
support. 


EASEL WORKBENCH AND 
CLIENT/SERVER DEVELOPMENT 

Easel Workbench was designed to help 
application developers best use the 
power of client/server computing. 
Workbench includes an integrated, 32- 
bit, OS/2-based development environ- 
ment, the event-driven EASEL lan- 
guage, an extensive variety of connec- 
tivity options, and a production system 
for the target user platform (OS/2, 
Windows, or DOS). Because the Work- 
bench supports a powerful client/serv- 
er framework, its connectivity options 
can integrate data from nearly any 
source. 


Support for the Database-Server Model, For 
applications that need to access data 
from a wide variety of back-end data 
sources, Workbench provides support 
for the database-server model of 
client/server. Like all Easel client/serv- 
er support, database processing occurs 
entirely on a separate thread, allowing 
the Easel client application to continue 
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operation. When results are returned, an 
Easel event, or “response,” is triggered. 
Database server results can be retrieved 
record by record, or written directly toa 
local file for bulk processing. 

Easel provides direct database server 

support for IBM’s Database Manager, 
the Oracle Server, Microsoft/Sybase 
SOL Server, and all databases support- 
ed by IBI’s EDA/SQL support. Easel’s 
support for the Database Manager is 
DRDA-compliant; where DDCS/2 is 
installed, applications can communicate 
transparently with all SAA databases 
including DB2, SQL/400, and SQL/DS. 
To insulate developers from the com- 
plexity of each unique database API, all 
Easel database drivers provide a high- 
level common programming interface, 
which lets a programmer change the 
back-end database without changing a 
client application. Multiple connections 
to the same or different database 
servers can also exist simultaneously, 
allowing the integration of information 
from multiple sources. 
Support for the Transaction-Server Model. 
Easel provides transaction server sup- 
port with three main technologies: 
stored procedures, CICS-OS/2, and the 
Easel Transaction Server (ETS) Toolkit, 
shown in Figure 3. 

Stored procedures are transactions 
containing compiled SQL and process- 
ing logic stored within the database 
server. For database servers that sup- 
port stored procedures such as 
Microsoft/Sybase and Oracle SQL 
Server, Easel applications can initiate a 
procedure on a separate thread. When 
the procedure has completed process- 
ing, the application is notified by way 
of an Easel event 

Easel provides a high-level interface 
to CICS-OS/2 that makes it easy for an 
application to initiate transactions 
residing on CICS-OS/2 workstations or 
hosts. CICS transactions can be initiat- 
ed with a simple subroutine call to 
CICS’s Extended Call Interface, includ- 
ing a transaction name and an input 
and output structure. The request is 
processed on a separate thread and the 
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application is notified upon comple- 
tion. At that time, the output structure 
is populated with any data returned 
from the database. 

Easel Workbench includes the ETS 
Toolkit, which allows developers to 
create and access OS/2-based transac- 
tions with a remote procedure call 
mechanism for all SAA databases 


OS/2 or Windows Client 


Figure 3. The ETS Toolkit 


(Database Manager, DB2, SQL/400, 
and SQL/DS). ETS transactions, based 
on the Database Manager’s application 
remote interface, are written by creat- 
ing procedures of SOL and processing 
logic within an ETS C or COBOL tem- 
plate. Easel applications can initiate a 
server transaction with the ETSExecute 
subroutine. The request is delivered to 


OS2/ Server 


EASEL Language 


Figure 4. Integrated development environment 
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Table 1. Easel event types and responses 


the OS/2 server on a separate thread, 
with NetBIOS on OS/2 Extended Ser- 
vices or the APPC SQL00 protocol with 
Remote Data Services. The server pro- 
cedure can execute directly against the 
Database Manager or, if DDCS/2 is 
installed, can connect to DB2, SOL/ 400, 
or SOL/DS. 


Support for the Peer Model. Easel pro- 
vides peer support for developers with 
the APPC protocol. To provide the 
most control while shielding complexi- 
ty, there are two APPC interfaces, auto- 
matic and controlled, The automatic 
interface takes care of the necessary 
acknowledgments and_ implicitly 
switches conversation states from send 
to receive without forcing developers 
to perform subroutine calls. For more 
complex applications, the controlled 
interface gives developers complete 
control over the details of the APPC 
conversation. 

APPC events appear like all other 
Easel events—as uniquely identifiable 
external responses. Like all other 
client/server support, APPC messag- 
ing and communications occur on a 
separate thread, allowing the applica- 
tion to continue running during peer 
processing. 


Support for the Distributed-Presentation 
Model. Easel supports the distributed- 
presentation models with high-level 
support for HLLAPI, VT-100, and asyn- 


Table 2. Ways to use Easel action statements 








Table 3. External libraries provided with Workbench 


chronous communications that mask the 
complexity of the underlying API. For 
example, applications are notified of 
incoming asynchronous data from Com- 
puServe through Easel responses. 
Through the HLLAPI provided by 
most PC emulators, Easel applications 
can access 3270 and 5250 applications. 


Easel can also access applications on 
various platforms through other proto- 
cols, with Software Corporation of 
America’s TalkThru emulator. The 
functions available from HLLAPI sup- 
port include: 

¢ To retrieve host data: ReadField, Get- 

FieldAttribute, ReadScreen, ReadLine. 
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¢ To write data to host: WriteField, 
PressKey, EnterString. 

¢ For host synchronization: Watch- 
ForStringAt, WatchForCustorAt. 

¢ Other: EmulateAndWatch, GetSessionSta- 
tus, SetEmulatorWindow. 





Support for Hybrid Applications. A single 
graphical interface can implement any 
number of client/server models that 
access data throughout an enterprise. 
| ! ‘Stim lito ey | Through its support for multiple mod- 
specu ast i Layout editor, } els, a single Easel application can 
| = nee: = | update diverse systems with the same 
data. Many companies use Easel appli- 
cations to transparently keep multiple 
systems in sync. 


THE EASEL LANGUAGE 
The EASEL language is a high-level, 
event-driven language designed for 
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m developing applications with a graphi- 


cal interface for all client/server mod- 
els. Easel applications can run under 
O0S/2, Windows and DOS. Under OS/2 
2.0, they use the 32-bit architecture and 
graphics engine. 

EASEL shields developers from the 
complexities of (and differences 
between) the underlying operating 
platform and connectivity APIs. Its 
complete set of programming con- 
structs provides facilities for develop- 
ing and controlling an application’s 
graphical interface, communications, 
database access, and processing logic. 


EASEL Objects. At the core of the EASEL 
language are objects that correspond to 
other objects with visual attributes. These 
objects include familiar OS/2 and Win- 
dows dialogue boxes and controls, as 
well as special Easel objects such as 
image regions (windows that hold 
bitmap images) and graphical regions 
(windows that hold scalable vector 
graphics). All objects have attributes such 
as visibility, color, and size that can be 
queried and changed at runtime. Objects 
can be created either visually in Easel 
Workbench or dynamically, based on 
data received during runtime. Objects 
can also be grouped into classes to which 
a single action can be performed (such as 
making them all invisible). 


Event-Driven Programming. Easel's non- 
procedural, event-driven nature allows 
developers to quickly prototype and 
incrementally add new functionality as 
needed. To respond to user and system 
activities, developers write responses to 
events of the types shown in Table 1. 


Robust Language Constructs. Within a 
response, developers can choose from 
a set of action statements that control 
application behavior. Table 2 lists ways 
to use these actions. 


Extensible. Developers can also access 
routines in external libraries or modules. 
Easel provides a complete set of 
libraries, but developers can create their 
own. Table 3 lists some of the external 
libraries provided with Workbench. 


‘as if 


Terp: Invoking action Prep_SituationHero 


Terp: Copying “SELECT distinct JOB.HERO_||| | 





Table 4. Easel Workbench tools for all phases of the development cycle 


Terp: Copying “HERO ID" to KevName —= 
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make HeroList_DB permanent 
clear Hero_LB~ fi 
if [SearchType = “Nemesis RB") | 
copy SQLKeyArray(NEMESISKey, | 
action Prep_NemesisHero 
make HeroList_GR visible 
else 
if (SearchType = “Situation_ 
copy SQ@LKeyArray[S!TUATION || 
action Prep SituationHero | 
make HeroList_GR visible 
else : 
copy HeroDuJour to HERO_ID) 
# action Select_HERO 


Figure 6. Workbench debugging facilities 


IMPLEMENTING WITH 

EASEL WORKBENCH 

EASEL, along with support for its 
client/server models, is the foundation 
for the Workbench, a 32-bit, OS/2- 
based integrated development environ- 
ment in which developers can visually 
define a user interface, add application 
logic, and test and debug Easel applica- 
tions. This environment is shown in 
Figure 4. 


Parts Catalogue. Central to the Work- 


copy [selected line from Searc chs 


Customer Information- 


| | Address: | 


Hero Dispatching System 


Receive Customer information 
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bench is the parts catalogue (shown in 
Figure 5), which allows developers to 
browse, edit, and create the compo- 
nents of an application with a listing of 
project views, or modules, and a hierar- 
chical presentation of application parts. 
Selecting a part loads and launches the 
associated editor. Double-clicking on 
any part, for example, launches the 
appropriate visual editor for quick 
modifications. All modifications are 
incorporated into the application by an 
incremental compiler that speeds up 
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the development cycle. The parts cata- 
logue also displays project views, 
which are stored in ASCII files that pro- 
vide simple integration with version 
control systems. 


Visual Editors. Workbench’s visual edi- 
tors allow you to define the interface in 
a WYSIWYG environment. CUA moni- 
toring can check an interface against 
Common User Access rules of interface 


design. The visual editors are listed in 
Table 4. 


Debugging Facilities. Application logic is 
added with Easel’s integrated text edi- 
tor. Debugging facilities, shown in Fig- 
ure 6, include: 


* Source-Level Debugger. This facility 
displays executing source code. 


Developers can _ visually step 
through statement-by-statement or 
by individual procedure, set break- 
points, and change runtime values. 


¢ Trace Windows. This facility displays 
a detailed record of an application's 
execution. Developers may open 
several trace windows and set filters 
to customize the type of information 
monitored in each window. 


¢ Stack Window. This facility displays 
the level of nesting that occurs dur- 
ing program execution. Developers 
may inspect and change variables 
on the stack. 


Example. The insurance representative 
workstation shown in Figure 7 inte- 
grates data from two client/server 


models and makes extensive use of 
images. When compiled for OS/2, the 
application automatically exploits the 
32-bit API. 

The work of this application was 
formerly a paper-based process in 
which a_ representative entered 
appraisal forms into an aging host- 
based system. The organization want- 
ed to transfer part of the system to 
Database Manager and reengineer the 
entire process with PC and imaging 
technology. 

The Easel system developed to 
address this problem controls an image 
bank on a minicomputer, which 
responds to the clerk pushing a button 
by issuing commands to download the 
next scanned appraisal form and item 
photograph in the processing queue. 
After reviewing the form in a window, 
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1993 CONFERENCE & EXHIBITION 


The software industry is changing. 
Businesses are rightsizing, new GUI plat- 
forms are in the news, and software and 
operating platforms are becoming ever 
more important variables in today's busi- 


ness computing equation. 


You have a lot to keep up with today. 


So, we're retooling two great industry 


events to help you do just that. 


WINDOWS & OS/2 
BECOMES BUSINESS 
SOFTWARE SOLUTIONS 


First , Windows & OS/2 has changed its 
name to Business Software Solutions. 


Why? To let you know we're keeping up 





Business Software 
Solutions 


CONFERENCE & EXHIBITION 


OUR NEW GOOD LOOKS 
ARE NICE, BUT IT’S WHAT'S 
INSIDE THAT COUNTS. 


with your growing need to bring 
cost effective GUI-based solutions to 
your business. 


At Business Software Solutions you'll 


get the best of the old Windows & OS/2 





Conference. You'll still find the hottest 


software for today’s key GUI-based plat- 
forms. You'll find test drive centers where 
you can try out apps before you buy. And 
you ll find many of the biggest name 


industry gurus telling you like it is about 


whats hot and what's not. 

But we've added so much more, you'll 
barely recognize the place! 

First, we've rebuilt the conference 
program from the ground up to provide 
you with much more value. Whether you 
manage your own business, or work for 
one of the Fortune 500, you'll find the 
answers you need about todays GUI- 
based platforms and software. 

You'll discover how to make sound 
buying decisions that insure your invest- 
ment as technology changes. You ll learn 
whether or not it's a must to settle on just 


one platform for your business. You ll 


learn how to set up and manage multiple 
platforms over a network. 

Then, you'll find how to use the most 
cost-effective training tools and techniques 
to support and train your end-users. You'll 
discover how to give your enterprise easy 
access to legacy data on the desktop. And 
you ll learn how to build Windows and 
O$/2 solutions that meet the real needs of 
your end users. 

On top of that, we've added a 
Solutions Interchange Room where you 
can trade ideas with peers, a Solutions 

Theatre for head-to-head vendor demos, 
and much more! 

All in all, you'll find the whole event 
focused on how to help you solve your 


biggest end-user computing problems 


using the best of today’s desktop technolo- 


gy PLUS you'll get a glimpse into what's 


coming next after Windows and OS/2. 


SOFTWARE DEVELOPMENT 
’93 JOINS BUSINESS 
SOFTWARE SOLUTIONS 
Take the newly refocused Business 
Software Solutions Conference and add 
the largest and most respected technical 
conference and show for anyone involved 
in building desktop or client-server appli- 
cations, What have you got? A dynamic 
industry event that reflects the entire desk- 
top software process from development to 
final applications and solutions! 

SD has long been seen as the best 
place to get unbiased, here's-how informa- 
tion on developing for the desktop, With 


over 150 courses in tracks ranging from 
Windows, OS/2 and UNIX development, 
to Analysis & Design, C++, Client-Server 
development, User Interface Design and 
Management, you'll have a hard time 
choosing which sessions to attend. 


And, again, that's not all. On the 


show Hoor you'll see the best available 





WE CHANGED OUR 
LOOKS TO GET YOUR 
ATTENTION... 

But we know that it's what's inside that 
counts. And whether youre interested in 
the solutions side or the development side 
of the desktop software equation, at 
Software Development and Business 
Software Solutions youll find answers to 
more of your business software questions 
than ever before in two quality confer- 


ences and more than 250 exhibits. 


To get detailed information on what 


you'll find when you arrive, return this 


: Come SEE FOR YOURSELF. AUGUST 23-27 IN 


BOSTON AT THE HYNES CONVENTION CENTER. 


development products from leading tools 
vendors, SD was the site of Borland’s 
launch of Borland C++ last year, and 


Microsoft's Visual C++ and 40 other 


new products this 
February. This August 
you'll find more of the 
hottest tools on the 
market. And, you'll get 
an extra bonus. Thats 
because your SD ticket 
also gets you into 
Business Software 
Solutions, the software 
solutions showcase of 


the summer. 
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coupon, phone us at 415-905-2784 or fax 
us at 905-8100 today. We'll send you a 
complete conference catalog, and a ticket 


for a free show pass. 





YES! TELL ME MORE! 


Please send me more information about your 
two conferences & exhibitions being held 
concurrently in Boston, August 23-27, 1993. 
I Business Software Solutions 

I Software Development 
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600 Harrison Street « San Francisco, CA 94707 
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the clerk enters the first few letters of 
the owner’s last name into a dialogue 
that invokes an ETS transaction against 
the Database Manager to present a list 
of matching names. When the clerk 
selects a name, the system issues a 
transaction that returns the owner's 
complete profile, including a list of 
appraised items. The clerk then adds 
the item by entering information into 
the dialogue box, and Easel updates the 
existing host-based system through the 
distributed presentation and logic 
model. With other transactions, it 
updates the database with the new 
insurance premium. Finally, the clerk 
can send a form letter by pressing the 
Correspondence button (which initiates 
Microsoft Word, loads a form, and 
enters the owner's name and updated 
list of appraised items via DDE). 


Chris Brookins, Easel Corp., 25 Corporate 
Drive, Burlington, Mass. 01803. Brookins is a 
product manager at Easel. He has been actively 
involved with the EASEL language and Easel 
Workbench for three years. Prior to joining 
Fasel, Brookins was a manager of systems plan- 
ning at General Electric. He holds a B.S. in com- 
puter science from Lehigh University. 
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Figure 7. Clerk's insurance workstation application 
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The ICSS Speech Recognition API helps programmers develop applications that recognize and process a contin- 
uous flow of spoken English words. This article explores the main functions and features of the ICSS software 


and provides a programming example. BY VINCENT STANFORD and BRANDON BOOTH 


Speech-Enabling Your 
Applications With ICSS 


he ICSS Developer’s Program consists of 
prerelease software currently being system- 
tested by IBM. It is fully supported for pro- 
gram members; members give opinions, report 
bugs, and submit design change requests, which 
leads to improvements in process and product. 
The ICSS Speech Recognition API, currently 
being tested under the program, helps program- 
mers develop applications that recognize and 
process a continuous flow of spoken English words. 





ICSS PRODUCT FEATURES 


Speaker Independence. Though there are variations 
in human speech from person to person, unlike 
other speech recognition systems ICSS requires no 
speaker enrollment or user training. ICSS has been 
tested with a variety of accents and under high 
background noise conditions. Though perfor- 
mance varies, good recognition is possible in spite 
of a variety of accents and background conditions. 


Continuous Speech. Users can speak at natural or 
rapid rates with successful recognition. This is 
important for command and transaction applica- 
tions that require high-speed control of user inter- 
faces as well as for high-speed data entry by those 
who find keyboards difficult or uncomfortable to 


use. 


Large Vocabulary. \CSS provides recognition under 
multiple switchable contexts of up to 1,000 words 
each, With the context-switching feature, pre- 
loaded multiple contexts can extend the practical 
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reach of the system to complex real-world applica- 
tions. The base dictionary contains over 20,000 
words; users can add words without gathering 
additional speech samples or retraining the system. 


Client/Server Metaphor. The recognition server can 
support multiple applications running on the 
same machine. The recognition engine serves as a 
serially reusable resource for a desktop of appli- 
cations. 


Unlike other speech recognition 
systems, ICSS requires no speaker 
enrollment or user training. 


Grammar-Guided Recognition. [CSS is designed to lis- 
ten for and process specific sets of words and 
phrases based on predefined grammars. Its recog- 
nition engine uses context-related language mod- 
els to guide the search process that decodes text 
from speech. These language models can be 
bigrams (word-to-word transition pairs and prob- 
abilities) or finite state grammars. The models can 
be derived from either Backus-Naur form (BNF) 
grammars or example texts. 


Additional Product Information. \CSS provides devel- 
opment and run-time support for speech recogni- 
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Analog to Digital 
Conversion 


Figure 1. ICSS logical architecture 


tion-capable applications in the OS/2 
and AIX environments. For many 
tasks, recognition is performed at or 
near real time on contemporary 80486 
processors with five additional 
megabytes of main memory above that 
required for other purposes. Because it 
takes advantage of OS/2 2.1’s preemp- 
tive multitasking, ICSS begins to 
process speech data before the speaker 
finishes talking, increasing response 
time. 


What Kinds of Applications Can 
Use ICSS? 

ICSS can be applied to situations in 
which user productivity, space, or hand 
motion is at a premium. It is best suited 
for applications that have clearly 
defined sets of actions or data entry 
requirements that can be addressed by 
large vocabulary-continuous speech 
recognition. Users must be familiar with 
the command structure of their applica- 
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tions, but more freeform applications 
can be supported for limited domains. 

Users adapt to speech recognition 
quickly, and recognition rates improve 
as speakers use the system. The contin- 
uous speech mode supported by ICSS 
lets developers support high-speed 
multifield data entry (using a connect- 
ed utterance). Situations that are well 
suited for ICSS voice-enabled applica- 
tions include: 


¢ Processing transactions using 
GUI-based applications 

¢ Executing hands-free data entry 
so an operator can simultane- 
ously handle and catalogue an 
object 

¢ Retrieving data from informa- 
tion systems such as SQL data- 
bases 

¢ Supporting help desk opera- 
tions 

¢ Controlling simulators 
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¢ Controlling instruments 

¢ Navigating through user inter- 
faces 

e Data entry. 


HOW DOES ICSS WORK? 

The logical architecture of ICSS is 
depicted in Figure 1, which shows the 
major system components that make up 
the development and run-time systems. 


Analog to Digital Conversion. This compo- 
nent currently consists of an IBM audio 
capture-and-playback adapter (ACPA) 
card and its associated software driver. 
The adapter is available in Micro Chan- 
nel (MCA) and IBM AT Bus architec- 
tures. ICSS supports data acquisition 
using the ACPA at rates of 11KHz and 
22KHz in linear 16-bit PCM samples. Of 
the two rates, 22KHz provides the high- 
er accuracy but is computationally more 
demanding. 11KHz is adequate for 
most, if not all, applications. 
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| VIEW | 


step significantly compresses the 


<main.win_cmd> :; = FILE |EDIT speech data. 
TEXT [STYLE =| PAGE | Recognition Search. After data has been © 
| , vector-quantized, the feature vectors, 
FRARE (TOOLS: | ‘WINDOW | context word-pair grammars, and 
HELP |PAGE-UP | PAGE-DOWN . acoustic phoneme models are used by 


the recognition engine for actual recog- 
nition of the speech signal. This is done 
with Hidden Markov models for pat- 
tern matching of the acoustic data 
stream. 


Figure 2. “Window dressing” context supporting a command structure 





i= <digit> édigit> <digit> <digit> . 
::= ZERO | OH | ONE | TWO] ... | NINE. 


<pin> 


<digit> Speech Recognition API. The speech 


recognition API lets recognition clients 
| communicate with the ICSS recognition 
Figure 3. Setting up the BNF form of a PIN context engine. This allows several features: 


¢ Context-loading 





Data Conditioning and Rate Conversion. 
This step converts speech data from 
external to internal formats for use dur- 
ing the feature extraction phase of the 
recognition process. 


Vector Quantization. Once the speech 
data samples have been converted to 
the appropriate format, the feature 
extraction phase of the recognition 
process begins. The feature extraction 


e« Context-switching 

¢ Control of data acquisition 

e Return of text decoded from 
speech 

e Control of various runtime 
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IcSsStart Initializes the ICSS API code and data and prepares to start communications with the [CSS 
server. 





I(SSStartConversation Establishes communications with the requested ICSS server facility. 


ICSSDefineContext Requests the ICSS server to load a context into memory in preparation for guiding the ICSS 
listening process. 

ICSSGetValue Retrieves the setting of a specified ICSS control variable so the application program can 
verify the setting. 

ICsSSetValue Sets the value of a specified ICSS control variable so the application can customize ICSS to 
its requirements. 

ICSSListen Causes ICSS to begin listening to the specified source for speech. Once listening has started, 


ICSS returns control to the application program. 


ICSSGetSpokenWords Causes the ICSS server to retrieve the text representing the recognized speech, in order to 
return it to the application program. This text is not returned until the listening and 
recognition process is complete. 


ICSSPlayback Causes the ICSS server to play a specified digitized audio file on a specified output device. 
The application can use ICSSPlayback to play audio responses or prompts to the user. 

TCSSRemoveContext Removes a previously defined context from memory. ICSSRemoveContext can be executed to 
conserve memory. 

ICSSEndConversation Removes remaining active contexts and terminates communication with the ICSS server. 

ICSSEnd Cleans up ICSS API memory and resources. 


Table 1. Functions that may be invoked in the ICSS API 





parameters 
* Playback of prerecorded audio SEAS eo ose des esc eed eee deo ee eb pbk beck / 
files. /* Program name: reco.c +/ 


/* 0S/2 Developer Magazine, Issue: July/August 1993 */ 

| int aia a | /* Article: Speech Enabling Your Applications With ICSS Is Easy #*/ 
The context-switching capability Of  / quthor: Brandon Booth Phone: 301-240-3671 FAX: 301-240-3377 +/ 
ICSS allows user applications, operat- /* Description: Program for performing speech recognition. Loads */ 


ing as speech recognition clients, to | /# a context and executes it, returning the spoken +*/ 
load numerous contexts and switch /* words, which best match within the context. */ 
rapidly among them using the speech ‘ Program Requirements: Software : a Version 2.0 or better s) 
recognition API calls. The process Is IBM ACPA V1.02 Software support+/ 
involves activating a grammar for use /* Hardware : 486 DX Processor +/ 
during the recognition search process. /* Microchannel architecture +/ 
The API allows multiple applications im tin ae a ee u 
j aon <8 on 
on the same machine to treat the speech fe TBM NCACPA card +/ 
recognition engine as a successively |x Microphone */ 
reusable resource; context switching is SEB E EEE EI AAR RRR REE RRS | 


therefore a particularly important tech- 

nique when using multiple applications #include <stdio.h> 

in that each application has several cy ole 
| ) | #include <string.h> 

screens or commands and data entry 


processes. #include "“icssapi.h" 
Context Development. The context devel- Figure 4. Sample program for speech recognition (continued on page 88) 
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But don’t worry. It’s all in good clean fun. Because now there’s 
a fast, cost-effective way to create graphic, easy-to-use inter- 
faces for OS/2* 2.0 applications and tools. Introducing Graphics 
Interface Kit/2 (GIK/2), an AD/Cycle* product from IBM 
Programming Systems. 

GIK/2 makes it easy to produce and manipulate symbolic 
representations of data without writing a single line of Presentation 
Manager” code. It automatically generates C code, where 
you can link the graphic symbols to the application data 
they represent. This not only speeds up your development 
cycle, it also helps you create applications that are intuitive 
and easy-to-use. Simplify transaction systems. Make databases 
easy to access. Bring organizational charts to life. Track 
inventory with simple icons. Any application can be 
made easier with the right graphic front-end. And GIK/2 
can help you make it happen. 


7|BM, OS/2, AD/Cycle and Presentation Manager are registered trademarks of International Business Machines Corporation. ©1993 IBM Corp. 
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For orders or additional information, please call 
1 800 IBM-CALL and ask for Department $71. If you 
need graphic proof, ask for our evaluation demo which, 
by the way, is rated G. 











opment environment provides tools for 
activities required to build a speech 
recognition context, including: 


¢ Acontext BNF compiler that 
creates word pair, or bigram, 
language models and finite- 
state language models 

e A bigram-by-example language 
model builder 

¢ A supplemental dictionary 
processor 

¢ Anadd-word utility 

¢ Acontext test and checkout 
function. 


The ICSS API. Applications interact with 
ICSS through the ICSS API, which con- 
sists of eleven 32-bit C-language func- 
tion calls. A concept important to under- 
standing the API is that application pro- 
grams interact with ICSS as both client 
and server. In this case, the application 
is the client and ICSS is the server that 
provides speech-recognition functions. 
As each API function is called, the 
request is passed to the ICSS speech 
server for processing and the results are 
passed back to the ICSS API and 
returned to the invoking application. 

In general, it is necessary to perform 
the following functions to use ICSS: 


e Establish communications with 
the ICSS server facility 

e Establish a conversation with 
that server 

¢ Define any necessary contexts 
to the conversation to guide 
speech recognition 

¢ Start the ICSS listening process 

¢ Wait for any spoken words to 
be returned as text. 


To start associating these basic func- 
tions, Table 1 describes the functions 
that may be invoked in the ICSS API. 

To ensure that the ICSS API inter- 
acts correctly with the ICSS server, the 
API tracks the order in which these 
functions are invoked and the success 
or failure of each function. This hierar- 
chy of function invocation is tracked by 
maintaining a state for the ICSS API for 
each client application. For instance, 


#define SIZEBUFFER 256 


void quit (char *msg, long rc); 
void message (char *msg, long rc); 


FoR EROS EA a IE | 
/* main +/ 
[SORA IERIE ARATE TATA 
int main(int argc, char *argv’ ) 


char inputbuf*SIZEBUFFER ; 
char _ buffer°SIZEBUFFER ; 
long rc *.=4; 

long context = 0; 

long notdone = 1; 

long § spoke_too_soon; 

float utt_len; 

float acq_time; 

float reco_time; 


if(arge != 2) 
{ 


printf("The reco example program requires one argument. \n"); 
printf("The name of a context to do recognition against. \n"); 
printf("Example: reco /icss/appl/samples/r1/context/r1.m.ctx\n"); 


return 0; 
puts("Welcome to RECO, the ICSS api example program."); 


re = ICSSStart(NULL); 
if (rc != ICSS_SUCCESS) quit("Error: Start Failed" ,rc); 


rc = ICSSStartConversation(ICSS_IBMACPA, /* ADCType +/ 
ICSS_DEFAULT_INT,  /* ADCIFNumber +*/ 
ICSS_DEFAULT_STRING, /* FESystemName */ 


ICSS_DIRECT, /* FELinkType +*/ 
ICSS_DEFAULT_STRING, /* RPSystemName */ 
ICSS_DIRECT) ; /* RPLinkType  */ 
if (rc != ICSS_SUCCESS) quit("Error: StartConversation Failed" ,rc); 
rc = ICSSDefineContext(&context, /* ContextHandle  +/ 
argv'l , /* ContextName = +/ 


ICSS_DEFAULT_FLOAT,  /* InsertionPenalty*/ 
ICSS_DEFAULT_FLOAT, /* LanguageWeight */ 
ICSS_DEFAULT_FLOAT); /* GrammarWeight  +*/ 
if (re != ICSS_ SUCCESS) 
{ message(“Error: Define Context failed",rc); notdone = 0; } 


peiectione) 
printf("\nListen?‘yes,no >"); 
fflush(stdout) ; 
gets(inputbuf); 


if( (strstr(inputbuf,"NO" ) != NULL) || 
(strstr(inputbuf,"no" ) != NULL) ) { break; } 


else 
rc = ICSSListen(context, /* ContextHandle  +*/ 
ICSS_DEFAULT_INT, /* SpeechInputType +*/ 
ICSS_LIVE_MIKE, /* SpeechInputSource+/ 


Figure 4. Sample program for speech recognition (continued from page 87) 
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ICSS must be in a “listen” state to suc- 
cessfully perform ICSSListen and in a 
“conversation” state to perform ICSSGet- 
SpokenWords. 


A BNF FOR A CONTEXT 

ICSS uses contexts, derived from com- 
piled grammars or bigrams, to guide 
the speech-recognition process. The 
Speech Development Environment 
(SDE) tool set in OS/2 2.1 lets develop- 
ers create and test speech recognition 
contexts. 

The most important step in creating 
a context is application design. ICSS’s 
context-switching capability allows 
speech-recognition contexts to be 
designed to mirror application struc- 
ture. The windowing message structure 
enforced by most popular GUIs can 
provide guidance on organizing 
speech-recognition contexts. The ICSS 
recognition server can switch between 
the preloaded contexts defined for each 
major window. When a particular win- 
dow is focused on, it can use the 
speech-recognition API to switch to the 
appropriate speech context. For exam- 
ple, a word processor’s main window 
might have a “window dressing” con- 
text supporting a command structure, 
as shown in Figure 2. This context 
allows a user to speak any of the menu 
options (File, Edit, and so on). 

Developing several small contexts 
makes it possible to reduce the search 
space, or perplexity, during functions 
performed by the application. It also 
reduces error rates when the speech 
recognizer is operating under sub-opti- 
mal conditions such as high back- 
ground noise. 

A banking application, for example, 
might ask which service is requested 
(loan rates, checking services, new 
accounts, current account status, and so 
on). A context would then be defined 
for each of the expected replies to the 
application’s verbal or visual prompts. 
Once the user replies, the context is 
switched and a prompt (such as a 
request for a personal identification 
number, or PIN) is given. The BNF 
form of a PIN context could be set up 
as shown in Figure 3. 


This grammar in Figure 3 defines 
what can be said during a “listen” 
request. The engine will recognize the 
closest phrase in the grammar that 
matches an utterance. The rather sim- 
ple context in Figure 3 recognizes only 


digit strings; if the context is active, a BS 
phrase like “One, two, trees, six” would iJ 
probably be recognized as ONE TWO THREE #4 


SIx. The format works well, however, 
for inputs that do not contain “trick” 
sequences. 
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ICSS DEVELOPER'S PROGRAM 


The ICSS Developer’s Program 
offers three classes on speech 
recognition. Call (800) 627-8363 for 
an information package. There are 
three packages available: $3995.00 
for a bundle of 23 licenses and 
$299.00- and $699.00 for the small 
and large microphone packages, 
respectively. 


The program consists of a develop- 
er’s license and tools that enable 
applications for speech, as well as 
the runtime licenses needed to exe- 
cute these programs. The package 
also includes a developer's guide 
and a microphone. 

Technical support and develop- 
ment assistance is provided via the 
800 number. While there is cur- 
rently no technical support provid- 
ed on CompuServe, ICSS special- 
ists monitor the forums regularly 
and will respond to questions. Call 
(800) 627-8363 for information on 
ICSS demonstrations at trade 
shows and IBM briefing centers. 





REFERENCES 


IBM Continuous Speech Series Devel- 
oper’s Guide, Developer's Program 
Beta 1, December 1992. 


A SIMPLE PROGRAMMING 
EXAMPLE 

Figure 4 shows a sample program for 
speech recognition. The program loads 
a context and executes it, returning the 
spoken words that best match within 
the context. A copy of this code can be 
downloaded from library 13 in the 
OS2DF2 forum on CompuServe under 
the name “RECO.C.” The code will exe- 
cute successfully only if ICSS is on the 
system running it. 


NULL) ; /* SpeechInputName 
if(re != ICSS_SUCCESS) { i Listen Failed",rc); 
break; 


printf("\nBEGIN SPEAKING\n") ; 


+/ 


rc = ICSSGetSpokenWords(SIZEBUFFER-1, /* TextBufferLen  */ 
buffer, /* TextBuffer +/ 
&spoke_too_soon, /* SpokeTooSoon _— */ 
hutt_len, /* UtteranceLength +/ 
&acq_time, /* AcquisitionTime +/ 
&reco_time) ; /* RecognitionTime */ 


if (rc == ICSS_SUCCESS) 
{ 


printf("The spoken text was: “As \n",buffer); 
printf("Utterance Length /4.2f\n",utt_len) ; 
printf("Acquistion Time 74.2f\n",acq_time) ; 
printf (“Recognition Time 74.2f\n",reco_time) ; 


else 


message("Error: GetSpokenWords Failed" ,rc); 


break; 


} 
} 


rc = I1CSSEndConversation(); 


if (rc != ICSS_SUCCESS) message("Error: Conversation End Failed",rc); 


ICSSEnd(ICSS_LOCAL+ICSS_NOFORCE) ; 
puts("RECO Exiting."); 
return 0; 


} 


void quit(char *msg, long rc) 


printf("%s rc=4d %s\n",msg,rc,ICSSErrorString’rc ); 


exit(-1); 
return; 
} 


void message(char #msg, long rc) 


printf("%s rc={d {s\n",msg,rc,ICSSErrorString’rc ); 


return; 


Figure 4. Sample program for speech recognition (continued from page 88) 
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The IBM OS/2 32-Bit Porting and Technical Consulting Workshops give developers hands-on training and assis- 


tance in application porting. BY MARILYN JOHNSON 


OS/2 32-Bit Porting and 


Technical Consulting Workshops 


ing DOS, Windows, UNIX, and 16-bit OS/2 

applications to 32-bit OS/2 with the IBM 
OS/2 32-Bit Porting and Technical Consulting 
Workshops, which provide hands-on training and 
assistance in application porting. The workshops 
focus on OS/2 32-bit features such as thread man- 
agement, multitasking, robust memory manage- 
ment, and full 32-bit APIs, with a focus on posi- 
tioning applications for portability. 

The workshops are led by industry experts who 
maintain expertise in current and future technolo- 
gy and have extensive experience in porting to 32- 
bit platforms. Workshop leaders’ experience with 
application porting allows: 


| BM is offering developers a way to port exist- 


Accurate sizing of the migration effort 
A minimized learning curve 
Architectural integrity 

A shortened development cycle 

35% to 100% of code ported. 


All workshops include extensive hands-on port- 
ing of code brought in by the participants. The price 
of each workshop includes meals, the use of lab 
hardware, and software to take home. Participants 
also receive class materials, the OS/2 2.1 operating 
system, and C Developers’ Workset/2 and Mullti- 
media Presentation Manager/2 (MMPM/2). 


WINDOWS 3.X TO OS/2 32-BIT PRESENTATION 
MANAGER NATIVE WORKSHOP 

This five-day workshop is for Windows 3.x appli- 
cation developers who want to expedite porting 


Windows code to the 32-bit OS/2 platform, allow- 
ing Windows 3.x applications to exploit OS/2 
memory management, multithreaded design, and 
the Presentation Manager (PM) interface. The 
workshop involves extensive hands-on porting of 
developers’ source code, including instruction and 
assistance from a porting expert. 

The workshop highlights architectural changes 
necessary to port, including comparisons between 
Windows 3.x and OS/2 program design and dis- 
cussion of the Windows 3.x 16-bit segmented 


The workshops focus on features 
such as thread management, multi- 
tasking, robust memory management, 
and full 32-bit APIs, with a focus on 
positioning applications for portability. 


memory management versus the 32-bit flat 
address space of OS/2 2.1. Students explore the 
benefits of OS/2 memory pools, guard pages, 
shared memory, page allocation techniques, and 
multi-threaded design. 

The workshop also covers programming to PM 
under OS/2 2.1. Participants will discuss forms of 
interprocess communication that allow OS/2 
processes to share and pass data and also compare 
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the OS/2 DOS APIs to functions provid- 
ed with the C run-time environment. 
The workshop covers common controls 
(such as the container, notebook slider, 
and value set) and common dialogues 
(such as the file and font dialogues), 


now a part of the OS/2 operating sys- 
tem. Finally, the class looks at the 
MMPM/2 Toolkit and its features. 

As part of the Windows 3.x to OS/2 
32-bit workshop, attendees use new 
porting tools that help convert applica- 
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tions to the OS/2 2.1 PM platform. 

Prerequisites for this workshop are 
Windows 3.x and C programming 
experience as well as an existing Win- 
dows 3.x application. 


DOS TO OS/2 32-BIT PRESEN- 
TATION MANAGER WORKSHOP 
This seven-day workshop is for DOS 
application developers who want to 
port existing applications to the OS/2 
32-bit PM platform, allowing DOS 
applications to exploit OS/2 memory 
management, multithreaded design, 
and the CUA PM interface. The work- 
shop involves extensive hands-on port- 
ing of the developer's source code, 
including instruction and assistance 
from a porting expert. 

During the week, experts discuss 
how to map BI0S-based functions to PM 
APIs and ‘how to redesign the user 
interface to take advantage of PM pro- 
gramming. It also covers those 32-bit 
OS/2 functions equivalent to DOS INT 
functions. 

OS/2 32-bit flat addressing memory 
management, making the best use of 
OS/2's virtual address space, OS/2 
memory pools, guard pages, shared 
memory, and page allocation tech- 
niques are all covered. 

The concepts of multitasking with 
OS/2 processes and threads are dis- 
cussed in depth. Topics include inter- 
process communication and offloading 
work to multiple processes and threads 
of execution. 

Common controls that allow DOS 
programmers to spend more time on 
code specific to their application are 
reviewed, then the instructor demon- 
strates how to incorporate MMPM/2 
into newly ported OS/2 applications. 

Prerequisites for this workshop are 
DOS and C programming experience 
as well as an existing DOS-based C 
application. 


SYSTEM OBJECT MODEL/ 
WORKPLACE SHELL WORKSHOP 
This five-day workshop provides 
detailed information about OS/2 32-bit 
System Object Model (SOM) program- 


ming. It shows how to interact with the 
Workplace Shell and takes advantage 
of future SOM enhancements with min- 
imal impact on source code. The work- 
shop features extensive hands-on appli- 
cation development. 

During this week, the instructors 
discuss similarities and differences of 
SOM and C++ as well as differences 
between Workplace Shell and non- 
Workplace Shell applications, identify- 
ing which modules should or should 
not become Workplace Shell objects. 

Attendees learn how to integrate 
existing OS/2 applications into the 
Workplace Shell by sub-classing exist- 
ing SOM and Workplace Shell objects, 
enabling applications to take advantage 
of the methods and default actions pro- 
vided by the object-oriented Workplace 
desktop. 

Prerequisites for this workshop are 
32-bit OS/2 and C programming expe- 
rience, as well as knowledge of the 
principles of object-oriented program- 
ming. 


OS/2 16-BIT PRESENTATION 
MANAGER TO 32-BiT PRESEN- 
TATION MANAGER WORKSHOP 
This five-day workshop enables OS/2 
developers to port their existing C 
applications to the OS/2 32-bit PM 
platform. This includes taking advan- 
tage of the flat memory model, better 
interprocess communication, and 32-bit 
execution vs. “thunked” 16-bit code. 
The workshop involves hands-on port- 
ing of the developer’s source code, 
complemented by instruction and assis- 
tance from a porting expert. 

Differences between 16-bit and 32- 
bit OS/2 subsystems, focusing on areas 
such as the new memory model, are 
reviewed. OS/2 2.1 flat memory 
addresses vs. 16-bit segmented memo- 
ry architecture are discussed, as are 
new memory features such as sparse 
memory objects and page guards. The 
class explores how 16-bit modules com- 
municate with 32-bit modules and the 
ramifications of “thunking” to 16-bit 
code. 

The instructors then address thread- 
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ing features available in OS/2 and 
OS/2 2.1, including suspending and 
resuming threads of execution and the 
system's ability to manage stack mem- 
ory for applications using threading. It 
then covers the changes and enhance- 
ments to interprocess communication 
between processes and threads. 

The workshop focuses on the new 
and changed Base Services APIs and 
their C run-time counterparts; it also 
introduces OS/2’s common controls 
and and standard dialogues, which 
reduce the code required to perform 
common interfaces (for example, pro- 
viding a dialogue of drives, directories, 
and files). Finally, it covers perfor- 
mance enhancement aids and tools, an 
introduction to MMPM/2, and adding 
multimedia to OS/2 applications. 

Prerequisites for this workshop are 
experience in OS/2 1.x and C program- 
ming and an existing OS/2 1.3 applica- 
tion. 


UNIX TO OS/2 32-BIT WORKSHOP 

This five-day workshop is for UNIX/X- 
Windows application programmers 
who want to port or reimplement 
applications on the OS/2 32-bit plat- 
form and also for programmers who 
want to include OS/2 in their UNIX 
environment. The workshop fosters a 
broad-based understanding of OS/2 
components by comparing UNIX and 
OS/2, which helps developers under- 
stand how to provide existing applica- 
tion function in the OS/2 environment 
and how to exploit unique features of 
OS/2 to extend or enhance existing 
function. Capabilities and interfaces 
common to both UNIX and OS/2 are 
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emphasized to expedite porting and 
preserve application architecture and 
design wherever possible. 

During this workshop, instructors 
give an overview of OS/2 and identify 
the programming environment and 
development process. The class com- 
pares OS/2 and UNIX-based operating 
system concepts, interprocess communi- 
cation using shared memory, pipes, 
queues, semaphores, transmission con- 


All workshops include 
extensive hands-on 
porting of code brought 
In by the participants 


trol protocol/internet protocol (TCP/IP) 
sockets and RPC, NetBIOS, and SNA 
basics. The class discusses the interoper- 
ability of X-Windows and PM and OS/2 
security in standalone and LAN envi- 
ronments. 

Prerequisites for this workshop are 
UNIX/X-Windows and C program- 
ming experience as well as familiarity 
with standard development tools. 


Marilyn Johnson, /8M Corp., [000 N.W. 
51st St, Boca Raton, Fla. 33431. Johnson 
has been with IBM since 1980 and with the 
worldwide Developer Assistance Program 
since 1989. She is the program manager 
for the porting and technical consulting 
workshops. 
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Since 32-bit OS/2 was released last year, more than 1,200 OS/2 applications have appeared 
on the market. Each issue, this column will note new product releases in the OS/2 world. 


New Products, New Support 









Siok Borland C++ for OS2. Borland’s new C++ 
soled for OS/2 makes quick creation of pow- 
erful C and C++ applications easy with a graphical 
environment and a suite of visual tools, including 
Turbo Debugger GX, C++ includes an optimizer 
for 32-bit code generation and is designed with 
ANSI C Certification and AT&T C++ standards. 






Borland International Inc. 
Phone: (800) 331-0877 Fax: (408) 439-9103 
Digitalk PARTS Workbench for 0S/2. The PARTS 
Workbench is a 32-bit client/server technology 
integration tool that lets programmers assemble 
and reuse parts. The product comes with 67 visual 
parts (Window, Button, and Text Pane) and nonvi- 
sual parts (dynamic data exchange, launch pad, 
and Btrieve). These components, plus others from 
Digitalk and third-party vendors, can be linked 
together to form applications. 


Digitalk 

Phone: (800) 531-2344 Fax: (310) 645-1306 
HockWare VisPro/REXX. VisPro/REXX helps pro- 
grammers create powerful and professional OS/2 
2.x programs with REXX in a GUI environment. 
VisPro/REXX exploits all OS/2 controls while 
enabling all the REXX features, including interac- 
tive debugging, APPC, HLLAPI, and OS/2 Data- 
base Manager interfaces. 


HockWare Ine. 


Phone: (919) 387-7391 Fax: (919) 380-0757 


IBM C Developer's Workset/2, The C Developer's 
Workset/2 consists of several programs designed 


to maximize developer productivity. Included in 
this package is the IBM high-performance C Set /2 
compiler and debugger, the IBM WorkFrame/2 
project-oriented development environment, and 
the IBM Developer's Toolkit for OS/2, which fea- 
tures a collection of language-independent build 
tools, productivity tools, sample programs, refer- 
ence information, and a kernel debugger. IBM also 
offers a free quarterly compiler newsletter that can 
be ordered by fax. 


IBM Corp. 
Phone: (800) 342-6672 
Fax: (416) 448-6057 (for newsletter only) 


PSS Tape Solution Series. Parallel Storage Solutions 
offers their Tape Solution Series, the only tape- 
backup on the market specifically designed for use 
with OS/2. For independent or network users, it 
protects data quickly and efficiently. Coupled with 
a tape backup device, the software provides the 
fastest backup speed on the market. 


Parallel Storage Solutions 
Phone: (800) 998-7839 Fax: (914) 347-4646 
WATCOM C/C++32. C/C++32 is a 32-bit multiplat- 
form optimizing compiler package with a compre- 
hensive toolset, including a debugging system, 
profile, linker, make utility, and other tools. 
C/C++32 features include full C++ implementa- 
tion with templates, exceptions and nested types, 
and an advanced code generator with 486 and 
Pentium optimization. 


WATCOM 


Phone: (519) 886-3700 Fax: (519) 747-4971 
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APPLICATIONS 


— L Cirrus Unite 2.0. Unite is an integrated 
= S\_I client/server-based document i imaging 
solution designed to reduce paper handling while 
increasing productivity. A true multitasking appli- 
cation for LAN use, Unite 2.0 supports optical juke- 
box technology for storage, fax, and print output. 


Cirrus Technology Inc. 
Phone: (301) 698-1900 Fax: (301) 698-1909 
Lotus Applications. Lotus has recently shipped sev- 
eral of its most popular applications rewritten for 
OS/2 2.x to take advantage of multithreaded full 
32-bit support. The OS/2 2.x versions of Ami Pro, 
1-2-3, Freelance Graphics, Notes, and cc:Mail all 





offer drag and drop capabilities and Workplace 
Shell integration. 


Lotus Development Corp. 
Phone: (800) 872-3387 


WordPerfect 5.2 for 0S/2. WordPerfect 5.2 is a graphi- 
cal word processing program that includes popular 
features such as the Button Bar, ruler, QuickFinder, 
and QuickMenu, as well as drag-and-drop capabili- 
ties and new macros. It supports all documents cre- 
ated in previous versions of WordPerfect. 


WordPerfect Corp. 


Phone: (800) 451-5151 Fax: (801) 222-5077 





DEVELOPER SUPPORT 


‘{ | /BM Developer Connection for 0S/2. The 
—.! IBM Developer Connection for OS/2 is 
a new service designed to provide OS/2 develop- 
ers with the technical information needed to create 
OS/2 applications. The Developer Connection will 
also feature updated information, tips, techniques, 
sample applications, and beta code for upcoming 
IBM applications. 

The service, which consists of quarterly CDs 
and newsletters as well as electronically-accessible 
developer support, costs $199.95 per year. How- 
ever, developers who sign up for the Developer 
Connection before September 30, 1993 are eligible 
for an introductory price of $149.95 per year. 

For more information about receiving the 
Developer Connection, call 1-800-633-8266. 





New I.V. League Catalog. The IBM OS/2 Indepen- 
dent Vendor (I.V.) League showcases hundreds of 
books, magazines, courseware, and consulting ser- 
vices that support OS/2. Now, select member 
products are featured in the all new I.V. League 
Product Catalog. To order a free copy, call 1-800- 
342-6672. 
| 
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You WOULDN T THINK 
ABOUT REINVENTING THE 
WHEEL... WHY REINVENT 











REASONING? 
COMPANY AND FAX NO. R.S. No. 
Borland International Inc.: (408) 439-0115 COV4 
Burton Systems Software: (908) 233-0716 79 
Cognitive Software Inc. 93 
Computer Associates 4 
Creative Systems Programming: (609) 234-1920 60 
dSoft Development: (713) 378-7448 79 
Essex Systems Inc.: (508) 750-4699 53 
Easel Corp.: (617) 221-3099 19 
Gpf Systems Inc.: (203)873-2171 10 
Hookware: (919) 380-0757 15 
IBM Canada: (800) 445-2426 35 
IBM Programming Systems Cary Labs: (919) 469-7423 43 
IBM CUA Controls Library: (919) 469-4423 27 
IBM (DB2)—Programming Systems 59 
Take a quantum leap forward with The Integrated on Sian oe 
Reasoning Shell (TIRS). TIRS offers: IBM Personal Software Products: (407) 982-6408 54-55 
| Speed ~ Speech Recognition: (301) 240-3377 vi 
: te = IBM TIRS 6 
Fast performance with 32-bit processing | tav4 us Marketing and Services: (904) 238-3442 48a 
| IBM Programming Systems (WITT) 17 
Productivity eee Builders Inc.: (212) 629-8819 5 
 essal Intersolv 
a development and maintenance Impact Software: (818) 879-5593 = 
Intelligent Environments: (508) 750-4699 24 
WE Embeddability Kaseworks: (408) 448-4163 2 
. ane Stet : (203) 648-9587 61 
Fully integrates with your application | Micropolis: (612) 341-2114 22-23 
| Microway: (508) 746-4678 85 
| Mitnor Software: (918) 357-2869 92 
—" Flexibility | MSR Development: (409) 560-5964 77 
al Do it your way- Use your favorite DBMS | ygicrg Focus: (415) 856-6134 9 
Prentice Hall: (800) 448-3804 85 
Real Time Technologies: (708) 446-6886 Da 
TIRS features include multiple platforms (0S/2, Rightware Inc. 27 
VM, and MVS), frame-based reasoning with Sequiter: (403) 436-2999 COV3 
inheritance, a code generator (C and PL/1), eee wd rahi ss 
; i OFTOUC stems inc. 
anK-4 GUI Bevelopment environment | Software Developtnest Conference 1993 80-81 
For more information about TIRS, our other | Soft and GUI: (718) 934-2133 29 
OEM offerings, and our two month product Sottronies Tuc 4742) 5481875 2 
trial period call: Stac Electronics: (619) 431-1001 30 
; Token Technology: (408) 559-8661 65 
1-800-IBM-SOLV SDHez | Van Nostrand Reinhold 51, 101 
Outside the US: (408) 463-4381 ==: Watcom C for IBM PCs: (519) 747-4971 COV2,1 


IBM, TIRS, and OS/2 are trademarks ol the international Business Machines Corporation. Zinc Software: (801) 785-8996 41 





This article provides an in-depth walk-through of debugging routines using the REXX programming language's 
trace command. Programs can be tested entirely inside REXX without the use of external debugging tools. 
BY STEVE CLARK 


Debugging REXX Applications 


n The REXX Language : A Practical Approach to 

Programming, author Michael Cowlishaw 

states that the single design objective of REXX 
was “to make programming easier than it was 
before.” The simplicity of REXX allows program- 
mers to deal more directly with the logic of a pro- 
gram. 

The same design objective was applied to 
debugging REXX code. The REXX language 
includes many debugging features to make test- 
ing and debugging easier. Understanding where 
and how these debugging aids are used can 
improve the quality of your code and the efficien- 
cy of the development, testing, debugging, and 
documentation process. 

Most of the information and examples here are 
appropriate for all REXX operating environments. 
Specific OS/2 features are clearly noted. 


DEFINING TRACE ACTION 

The REXX language processor offers many trace 
actions for use in debugging. Setting a trace action 
determines the amount of trace information to be 
displayed and whether the trace is run interac- 
tively. This can be controlled within a REXX pro- 
gram by the TRACE instruction or the built-in TRACE() 
function. These share most of the same parame- 
ters and can be used interchangeably in many sit- 
uations. 

The trace action is defined by a single parame- 
ter made up of either a whole number or an alpha- 
betic character(vord) option. The number trace para- 
meter is only valid during interactive tracing. The 
most commonly used alphabetic character (word) 
options are: 


e Normal. Failed commands are traced after 
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execution. This is the default setting. 

¢ Off. All tracing is turned off. 

e Results. All clauses are traced before exe- 
cution and results are displayed. This is 
the most common option. 

¢ Intermediates. This option is similar to 
Results, but intermediate results are also 
displayed. 

e Labels. All labels are traced as they are 
passed. 


REXX recognizes an option by the first letter of 
its name so it is not necessary to type the full 
name. The alphabetic character(word) option may 
also include one or more question mark (?) prefix 
characters. The question mark prefix acts as a 
switch turning interactive tracing on and off. 
Examples of setting the REXX trace action using 
the trace instruction are shown in Figure 1. 

REXX trace parameters are described in detail 
in the OS/2 2.0 Procedures Language 2/REXX refer- 
ence manual. 


DIFFERENCES BETWEEN TRACE AND 
TRACE() 

If the TRACE instruction and the TRACE() function are 
so similar, why is it necessary to have both? In 
practice, the TRACE instruction is sufficient for most 
debugging tasks, and its simpler syntax is quicker 
to use. There are differences, however, between 
the two commands. The TRACE() function has some 
unique features that make it a necessary and valu- 
able debugging aid. 


The most obvious difference between TRACE and 


TRACE() is that the TRACE() function returns a result. 


The result is the current TRACE action. You can 
invoke the TRACE() function directly within an 
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expression, and the result will be eval- 
uated as part of the expression. Alter- 
natively, the TRACE() function can be 
invoked with the CALL instruction and 
the returned result will be assigned to 
the special variable RESULT. Examples of 
calling the TRACE() function are shown 
in Figure 2. 

Also, like other functions, TRACE() 
evaluates its option as an expression, 
whereas the TRACE instruction evaluates 
its option as a constant. The TRACE 
instruction is defined this way to sim- 
plify the syntax of the command and 
avoid surprises to the programmer. 
The instructions TRACE I or TRACE OFF will 
always set the expected trace action. 
However, using CALL TRACE I or CALL 
TRACE OFF may generate some unexpect- 
ed trace behavior if the symbols i or off 
have been assigned values. Figure 3 
illustrates that it is necessary to be 
explicit when using the TRACE() function 
and delimit the option with quotes. 

The intent in Figure 3 is to set the 
trace action to Intermediates. Instead of 
doing so, the language processor evalu- 
ates the variable i, which has been 
incremented to 11 by the do i=1 to 10 
loop. What is actually executed is CALL 
TRACE 11. 


This example points out another dif- 
ference. The number parameter, while 
valid for the TRACE instruction, is not 
valid for the TRACE() function. Using the 
number parameter with a call to the 
TRACE() function will generate a syntax 
error. 

The less obvious differences 
between the TRACE instruction and the 
TRACE() function become apparent dur- 
ing interactive tracing; during interac- 
tive trace, the REXX processor pauses 


Figure 1. Sample TRACE instructions 





Figure 2. Sample TRACE() function calls 


after most clauses for input from the 
keyboard. One exception is the TRACE 
instruction. Following a TRACE instruc- 
tion, the language processor will con- 
tinue to execute until the next pause. 
This is true whether the TRACE instruc- 
tion is in the file or entered from the 


Interactive trace allows programmers to monitor 
program execution, change variables, reexecute 
clauses, execute program routines, and even alter 
program flow: 


keyboard. In contrast, the language 
processor pauses after the TRACE() func- 
tion, as it does for all functions. 
Another difference is that during 
interactive trace, trace control is trans- 
ferred to the console. All TRACE instruc- 
tions in the program file are ignored. 
Only keyboard TRACE instructions are 
obeyed until interactive trace is 
switched off. In contrast, the TRACE() 
function is never ignored. The differ- 
ences between TRACE and TRACE() are 








summarized in Figure 4. 


TRACE OUTPUT 

As each clause is executed, the trace 
output is displayed to the user. The dis- 
play contains the executed source line 
number and text. A special symbol is 
also displayed to indicate the type of 
data being displayed. The *-* symbol 
indicates that the displayed data is the 
source text of the executed clause. The 
+++ symbol indicates a trace message 
from the language processor. 

When results are displayed, they are 
indicated by symbols that begin and 
end with the greater than sign (9). 
These symbols are shown in Figure 5, 


INTERACTIVE TRACE 
Interactive trace allows programmers 
to monitor program execution, change 
variables, reexecute clauses, execute 
program routines, and even alter pro- 
gram flow. The REXX processor pauses 
following the execution of most clauses 
and allows programmers to enter 
instructions from the console. In fact, 
all REXX instructions may be entered 
from the console during interactive 
trace. 

In addition, there are two special 
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Figure 3. Invalid TRACE() function call 


instructions that control execution dur- 
ing interactive trace. These two instruc- 
tions are the null line and the equal 
sign (=). Entering a null line by pressing 
the enter key will cause the processor 
to execute the next clause and continue 
executing until it reaches the next 
pause. 

Entering an = will reexecute the last 
clause traced in the current routine. 
This is an extremely useful command 
when used in conjunction with the 
available REXX instructions. If you are 


| Reprints available from 
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using the Results trace action and come 
across a complex line of code, you can 
switch the tracing action to Intermediates 
by executing the TRACE() function from 
the keyboard and then reexecuting the 
clause. The TRACE() function is used so 
the language processor will pause and 
not continue to the next clause. 

Figure 6 demonstrates this scenario. 
In the first execution of the clause, you 
can see that the variable x was com- 
pared to the result of the VERIFY() func- 
tion and the result of that comparsion 
is 0 or false. But since the values of the 
variables in this clause are unknown, it 
is difficult to see how the result was 
determined. So the trace action is 
changed with the TRACE() function and 
reexecuted to get more detail. The 
Results symbols now show that the vari- 
able (>¥>) ’x’ equals 1, string contains a 
date, delim_list contains a list of delim- 


iters, and that there is a literal (>L>) 
string M. The VERIFY function(>F>) has 
returned 3, the comparison operation 
(>0>) returned 0, and the final result is 0. 

During an interactive trace, vari- 
ables can be examined with the SAY 
instruction. The semicolon can be used 
to enter multiple clauses on a line. In 
fact, the processor requires that all 
instructions such as DO...END and 
IF... THEN be complete when entered, as 
in Figure 7. 

While monitoring the program exe- 
cution and examining the variables 
with the SAY instruction or through 
trace results, changing a variable’s 
value is invariably useful. Variables can 
be modified with an ASSIGNMENT instruc- 
tion, as in Figure 8. 

Program subroutines can be execut- 
ed directly from the keyboard with the 
CALL instruction. Subroutines can also be 








Maximize Performance 
with true 32-Bit Utilities 
for OS/2 Version 2 


* Recover damaged HPFS 
Volumes 

* Undelete Erased Files 

* Optimize HPFS Volumes 

* Edit Disk Sectors 

* Test Disk Media 

¢ Mass Erase Sensitive Files 

* Display Volume Information 

¢ Display System Information 


Full or partial reprints are available for all articles 
appearing in OS/2 DEVELOPER. 


Reprints can be customized to your specific 
needs. You choose color, size, layout, graphics, 
| quantity, etc. 


* Display File Fragmentation 

* Display Directory 
Information 

¢ Add Coments to Files 

e Alter File Timestamps 

* Locate Files 

¢ Monitor Boot Sectors 

* Alter File Attributes 

* Protect files 


Use your customized reprints for : 
| *customer support 
*sales tools 
*marketing support 
*education 


| Call or fax today for a custom quote: 


Gamma Tech Utilities 
Soffouch Systems, Inc. 
Workstation Division 
405/947-8080 - FAX 405/632-6537 


Laura Pullen 
OS/2 Developer 
Phone; 415-358-0126 ext 302 
FAX: 415-358-9749 











100 


exited at any point with the RETURN 
instruction. This means that a program- 


| mer can dramatically alter program 


flow. 

Program execution can also be halt- 
ed with the EXIT instruction, although it 
is better to exit by calling the program's 
exit subroutine (for example, CALL 
EXIT_PROG). The exit subroutine would 
have been coded to perform any neces- 
sary cleanup, such as dropping queues 
or deleting temporary work files. 


CONTROLLING INTERACTIVE 
PAUSES 

Two trace options control pausing dur- 
ing interactive tracing. One of these is 
the Labels option. This option changes 
the trace action to only trace and pause 
at label clauses. This is useful for limit- 
ing the amount of trace output and 
quickly progressing to the next subrou- 
tine of interest. Once a desired subrou- 
tine is reached, changing the trace 
action to Results or Intermediates will 
resume tracing of all clauses. 

TRACE L is also useful when examin- 
ing unfamiliar programs. Since only 
labels are traced, it can be used to gen- 
erate an outline of the program flow 
showing the order in which each sub- 
routine is executed. 

The other trace option used for con- 
trolling interactive pauses is the num- 
ber option. When a positive whole 
number is used as a trace option, the 
designated number of pauses will be 
ignored. Using a negative whole num- 
ber has the same effect on pausing, but 
trace output is suspended for the desig- 
nated number of pauses. 

The number option is most useful 
for debugging loops. After stepping 
through a loop once, the number 
option can be used to initiate a full exe- 
cution of the loop without pausing. 


INTERACTIVE TRACE OF SUBROU- 
TINES 

When a subroutine is to be traced, the 
programmer can start interactive trac- 
ing by adding a TRACE instruction to the 
source either within the subroutine or 
prior to the call to the subroutine. In 


either case, the subroutine will be 





Figure 4. TRACE vs. TRACE() behavior 





Figure 5. Symbols used in trace output 
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Inserting a trace instruction within 
a subroutine will cause tracing to begin 


9 #-* If x = verify(string, delim list, “M’); 





>>? “o" after entering the subroutine. There is 
no need to change the trace action 
Enter: CALL TRACE ‘I’ when the subroutine ends. That hap- 
Enter: = pens automatically. The trace action of 
the caller is saved, and when control 
9 +-* Tf x= verify(string, delim_list, “M’); returns to the caller, that trace action is 

>> nyu restored. 
>Y> "01/17/92" Ifa subroutine is called from numer- 
>> n= sm ous points ina program, it is not neces- 
>L> nya sary to locate each call and add a TRACE 
>> ngn instruction. Instead, a single TRACE 
| o Ais instruction within the subroutine will 
turn tracing on each time the subrou- 

>>> ng" 


tine is executed. However, because 
tracing does not begin until after entry 
into the subroutine, it is not apparent 
where the call to the subroutine was 
traced. The difference is the program- subroutine. Both approaches have their made or what the source of the subrou- 
mer’s control prior to and following the advantages. tines parameters were. Fortunately, 


Figure 6. Reexecuting a clause to get intermediate results 
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REXX provides a special variable and 
a built-in function for retrieving this 
information. The special variable SIGL 
contains the line number of the clause 
that transferred control to the subrou- 
tine, as shown in Figure 9. The built-in 
function SOURCELINE() used with the spe- 
cial variable SIGL will return the exact 
text of the clause that called the active 
subroutine. 

Adding a trace instruction prior to 
the call to a subroutine establishes the 


By moaitying the 
variables that make up 
the calling parameters 
and repeatedly calling a 
subroutine, subroutines 
can be fully tested ina 
single execution of the 
program. 
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trace action prior to, during, and after 
the execution of the subroutine. This 
allows a programmer to see exactly 
where the call takes place. It provides 
an opportunity to see and modify the 
subroutine’s calling parameters and to 
see and modify the result when the 
subroutine returns. It also allows the 
programmer to easily reexecute the 
subroutine. 

Since the REXX processor does not 
pause following a trace instruction, it is 
recommended that a NOP instruction be 
added following the TRACE instruction. 
The language processor will pause after 
the NOP instruction, which provides an 
opportunity to examine and possibly 
modify variables before entering the 
subroutine. The DEBUG_RX.CMD pro- 
gram illustrates this with the clause 
TRACE ?R; NOP just before the call to the 


Figure 7. Examining variables with SAY 








Figure 8. Altering program flow with an ASSIGNMENT instruction 


Figure 9. Displaying a subroutines caller 


DIFF subroutine. The TRACE instruction is 
used instead of the TRACE() function 
because it is ignored if interactive trace 
is already switched on. 

When the tracing action is set prior 
to calling a subroutine, that action will 
be in effect after the subroutine ends. 
The programmer can take advantage of 
this by using the equal sign (=) trace 
command to re-execute the call to the 
subroutine. The = reexecutes the last 
clause traced in the current routine. 
After control is returned to the caller by 
the RETURN instruction, the last clause 
traced in the current routine is the 
clause that called the subroutine. 
Therefore, entering = will reexecute the 





call to the subroutine, as shown in Fig- 
ure 10. 

This is an extremely efficient debug- 
ging technique. By modifying the vari- 
ables that make up the calling parame- 
ters and repeatedly calling a subroutine 
in this manner, subroutines can be fully 
tested in a single execution of the pro- 
gram. 

When using this technique, it may 
be desirable to quickly return to the 
calling routine and reexecute the sub- 
routine. There are two ways to do this. 
Entering TRACE OFF will turn off tracing 
until the subroutine returns to the 
caller. Entering the RETURN instruction 
will change the program flow and force 
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an immediate return to the caller. If the 
RETURN instruction is used in a subrou- 
tine called as a function, it must return 
a result, such as RETURN 0, or a syntax 
error will be generated. 

Once a tracing action is set, it will 
apply to any called subroutines. If 
there is no interest in tracing a subrou- 
tine, entering TRACE OFF will switch off 
tracing until that subroutine ends. But 
if a program contains a subroutine that 
is called repeatedly, such as a logging 
or messaging routine, it can be an 
annoyance to constantly be switching 
off tracing from the keyboard. In this 
instance, it is preferable to program- 
maticaly switch trace off with a clause 


During 
development, it can 
be very efficient to 
write and test many 
routines externally. 


in the offending subroutine. TRACE 
instructions in the program cannot be 
used for this purpose because they are 
ignored during interactive trace. But 
the TRACE() function can be added to a 
subroutine to programmaticaly switch 
tracing off. 


USING EXTERNAL ROUTINES 

Re-executing subroutine calls with the 
equal sign (=) trace command works 
very well with external routines. 
Whereas an internal routine cannot be 
changed and retested without ending 
and restarting the program, an external 
routine can be modified between calls 
without ending the calling program. 
During development, it can be very 
efficient to write and test many rou- 
tines externally. Once testing is com- 
pleted, they can be converted to inter- 
nal routines. If the file name of the 
external routine is kept the same as the 





Figure 10. Reexecuting a subroutine in interactive trace 


label, then the only conversion is to 
copy the routine into the program. 

In determining if this development 
technique is appropriate, keep in mind 
that there are no external variables in 
REXX. All of the caller’s variables are 
hidden from an external routine just as 
if a PROCEDURE instruction were used. The 
DIFF subroutine in the DEBUG_RX.CMD 
sample program is an example of a rou- 
tine that can be used unchanged either 
as an internal routine or as an external 
REXX routine. DIFF does not use any 
variables from the caller’s environment. 


It receives data through the calling argu- 
ments and returns data to the program 
as a result. To convert DIFF to an external 
routine simply copy the routine into a 
file named DIFF.CMD and delete it 
from the program. 


SAVING TRACE OUTPUT 

In the OS/2 operating environment, the 
REXX processor generally uses the 
default input and output streams STDIN 
and STDOUT to read from the keyboard 
and write to the display. Trace output, 
on the other hand, is written to the 
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Figure 11. Resetting trace action in a filter 


STDERR output stream. Thus it is very 
easy to save or print trace output by 
executing the program with STDERR redi- 
rected to a file or a printer. The lan- 
guage processor detects when STDERR 
has been redirected and will not allow 
interactive trace to be switched on. 
When using redirection, STDERR is refer- 
enced by the internal file ID (handle) 2. 
When entered at the OS/2 command 
prompt, this example will execute the 
program MYAPP and redirect any trace 
output to the file TRACE.OUT: 


MYAPP 2>TRACE.OUT 


The OS/2 PMREXX utility allows exe- 
cution and debugging of REXX pro- 
grams within a Presentation Manager 
window. It can also be used to save 
trace output. Among the many features 
of PMREXX are scrolling and saving out- 
put, selective copying to the clipboard, 
pasting to input, and switching interac- 
tive trace on and off with the mouse. 

PMREXX is an optional system utility 
in OS/2 2.0 and 2.1. If it was not origi- 
nally installed it can be installed from 
the OS/2 desktop by selecting OS/2 
System, System Setup, Selective Install, 
System Configuration (click on ‘OK’), 
OS/2 Setup and Installation, Optional 
System Utilities in OS/2 Installation, 
and PMREXX. 
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USING RXTRACE ENVIRONMENT 
VARIABLE 

The REXX processor provides an exter- 
nal means of switching on interactive 
trace in the OS/2 operating environ- 
ment. If the environment variable 
RXTRACE is set to ON, the language proces- 
sor will automatically set the trace 
action to 7R. It is, therefore, not neces- 
sary to modify a REXX source file to 
switch on interactive trace. The RXTRACE 
environment variable is most helpful 
for remotely debugging user problems 
that cannot be duplicated. The user can 
easily provide the trace information 
needed by switching trace on with SET 
RXTRACE=0N, executing the program with 
the trace output (STDERR) redirected to a 
file or printer, and then sending the 
output to the programmer. 

Using the RXTRACE environment vari- 
able works quite well unless the ‘?R 
trace action is not the preferred or 
appropriate setting. For instance, ?1 
might be preferred because it provides 
more detailed trace information. Or, if 
the program is a filter, then interactive 
trace is not appropriate because the lan- 
guage processor will try and interpret 
the STDIN input stream as REXX instruc- 
tions. In these cases, some additional 
code can correctly reset the trace action. 

The REVERSE.CMD sample pro- 
gram demonstrates how to program- 
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matically test and reset the trace action. 
REVERSE.CMD is a simple filter that 
takes lines from STDIN , reverses them 
with the REVERSE() built-in function and 
then writes to STDOUT. Because it is a fil- 
ter, REVERSE.CMD will not execute 
correctly in interactive trace mode. If 
interactive trace has been switched on 
using the RXTRACE environment variable, 
the first two lines of the program will 
reset the trace action. The first line calls 
the TRACE() function to query the current 
trace action and immediately turn trac- 
ing off. The current trace action is 
stored in the TRACE_VALUE variable. The 
second line checks TRACE_VALUE; if it was 
set to ?R, the trace action is reset to R, as 
shown in Figure 11. 


AUTOMATING TEST CASES 

An important part of application devel- 
opment and maintenance is verifying 
that a program works as designed in 


With the commands 
available in REXX, it 
IS simple to 

automate running 
test cases that will 
test the complete 
program or specific 
routines within the 
program. 

the original release and in successive 
generations of enhancements and 
maintenance. This validation is done 
with test cases. Two problems in run- 
ning test cases is the time it takes to 
execute them and the difficulty of 


designing tests that fully validate all of 
the program’s routines. With the com- 
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mands available in REXX, it is simple to 


| automate the running of test cases that 


will test the complete program or spe- 
cific routines within the program. 

It was discussed earlier that testing 
can be done during interactive trace by 
entering REXX instructions from the 
keyboard. Those instructions are inter- 
preted immediately by the language 
processor. The INTERPRET instruction will 
also process REXX instructions. Cre- 
ative use of the INTERPRET instruction 
allows programmers to exercise control, 
similar to interactive trace, from outside 
the program. 

The DEBUG_RX.CMD program, 
shown in Figure 12, demonstrates how 
to take instructions from a file of test 
cases and execute them with the INTER- 
PRET instruction. The RUN_TEST_CASES rou- 
tine in DEBUG_RX.CMD provides this 
function. If the program is started with 
a parameter of TEST, then the SIGNAL 
instruction transfers control to the 
RUN_TEST_CASES routine, which reads the 
DEBUG_RX.TST file. As each line is 
read, it is processed by the INTERPRET 
instruction. 

DEBUG_RX.TST, shown in Figure 
13, contains instructions that test the 
DIFF() routine in DEBUG_RX.CMD. This 
file looks similar to a REXX file because 
it contains REXX instructions; however, 
each line represents a literal string that 
will be processed by the INTERPRET 
instruction. INTERPRET requires that all 
instructions, such as 0D0...END and 
IF...THEN, be complete. Therefore, 
instructions and comments in the test 
case file cannot span multiple lines. 
Long instructions are pieced together in 
multiple assignment statements with a 
semicolon separating the clauses. The 
basic test scenario for DIFF() is assigned 
to the variable TEST in this manner. The 
test cases are run by changing the val- 
ues of the variables used in TEST and giv- 
ing the instruction INTERPRET TEST 
(RUN_TEST_CASES actually executes INTERPRET 
INTERPRET TEST). All messages are written 
to STDERR so they can be easily redirected 
to a file. 

Incorporating this method of saving 
and running test cases into the develop- 





Figure 12. Program that reads and executes its own test cases 
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Figure 13. Sample test cases for DEBUG_RX . CMD 





ment process improves the quality of 
the code produced, the efficiency of 
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development, and the level of docu- 
mentation. The quality of the code is 
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improved because there is a record of 
the actual test cases that have been run. 
The efficiency of development 
improves because test cases are cap- 
tured as each function is developed 
rather than as an afterthought once 
coding is complete. The level of docu- 
mentation improves because the test 
cases illustrate exactly what a piece of 
code is expected to do. 


SUMMARY 

Debugging REXX programs has a num- 
ber of similarities with other languages 
and debug utilities. Adding a trace 
command into a REXX program is 
equivalent to setting a breakpoint into 
other languages. Other languages or 
utilities may also have the ability to 
examine variables, set variables, and 
even step through program execution 
interactively. In addition, REXX has a 
number of unique debugging features 
such as the ability to change the trace 
action, execute instructions, and call 
subroutines interactively. It can also 
reexecute a line of code or a subroutine. 
These features combine to create a very 
efficient debugging environment. 


Steve Clark, /SSC Corp., Internal Zip 
WC7D, P.O. Box 2150, Atlanta, Ga. 30301- 
2150. Clark is a staff programmer in the Pro- 
grammable Workstation Applications 


Development department at the ISSC Solu- 
tion Center, Atlanta. He joined IBM in 1979 
and has worked in application development 
in IBM and ISSC since 1984. He has a B.A. 
in accounting from Georgia State University. 
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Smalltalk/V is a pure object-oriented language unencumbered by the need to support procedural code. With it, 
you can create robust production code more quickly than if you were to program from a C source. 
BY THEODORE SHRADER 


Enhancing Your 
Smalltalk/V Programs 








Theodore Shrader 


nlike C++, Smalltalk/V is a pure object- 
oriented language unencumbered by the 
need to support procedural code. With it, 
you can quickly prototype code, particularly that 
used to design and test graphical applications. The 
code can then be further refined to create robust 
production code, more quickly than if you were to 
develop from a C source. 





INTRODUCTION 

Making the transition from C (or another proce- 
dural language) to Smalltalk takes time. In a first 
attempt, developers are likely to shape the 
Smalltalk classes and methods to follow C pro- 
gramming concepts. For example, a new Smalltalk 


Unlike a compiled language, 
Smalltalk allows you to modify code 
while the program Is running and 


view your changes immediately. 
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developer may contain almost an entire program’s 
methods under one class, rather than subdividing 
the work among all the classes and reusing as 
much code as possible. One of Smalltalk’s great 
strengths is its ability to allow code to be subdi- 
vided and then frequently and easily reused. 
During the transition from procedural to object- 


oriented programming, there are many ways to 
refine code, improve performance, and make 
development and maintenance easier. Unlike a 
compiled language, Smalltalk allows you to modi- 
fy code while the program is running and view 
your changes immediately thereafter. Finally, you 
can improve program performance by becoming 
aware of how Smalltalk objects and methods inter- 
act. This article focuses on intermediate improve- 
ments you can make toward the design and imple- 
mentation of your Smalltalk/V for OS/2 code. 


DESIGNING 
One of the best ways to maximize code reuse is to 
focus on designing the class structure for your pro- 
gram. It helps to first analyze the classes shipped 
with Smalltalk; examining existing classes and 
methods can give you an idea of where to place 
your own classes and which classes can be recy- 
cled by your application. Planning ahead doesn’t 
mean that your initial class structure can’t be 
changed, but it will save you from having to 
rearrange classes and methods in the future. 
Wherever you place your classes, determine if 
it would be better to create a new class as a sub- 
class of an existing one (thus taking advantage of 
inheritance) or if you should simply add to the 
methods of one of the base classes. A new class of 
an object, such as Corps, should be made a separate 
class, whereas new string methods are better off 
placed in the String class since it allows them to be 
shared by all String objects. Make a log of those 
methods added to existing classes; methods can be 
forgotten as the change log and source files are 
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US Artillery US Cavalry 





US Infantry 


Figure 1. USUnit object subclasses with instances of the strength variable 


is Mounted 


is Mounted 





Figure 2. Responses to the isMounted message 


compressed. The log will allow you to 
move the code from one version of 
Smalltalk to another or from one image 
to another more easily. 

When adding a new class, it is a 
good idea to prefix the name of the 
class with a two- or three-letter prefix 
common to all the classes in your pro- 
gram (for example, USInfantry). This will 
keep classes sorted together or in clus- 
ters in the Class Hierarchy Browser, 
immediately identifying them to you or 


to other developers as those belonging 
to your program. (Some development 
environments for Smalltalk separate 
out the classes used for your applica- 
tion, shielding you from unused parts 
of the class hierarchy. This makes navi- 
gation easier, but with a good naming 
scheme you can minimize scrolling 
between classes and retain the same 
functionality.) 

Methods and variables should fol- 
low a naming scheme that Visually 





indicates parameters and object type. 
For methods, this means placing an 
abbreviated object name before each 
variable input. For example, the String 
method: 


replaceChar: aQldChar withChar: aNew- 
Char 


tells the unfamiliar or forgetful devel- 
oper that character (not string) objects 
are needed as input. 

Instance and class variables should 
also be named according to the type of 
object, as with aString, aChar, and 
strengthDict. The latter variable name 
tells the reader not only that the vari- 
able holds a dictionary, but also that it’s 
a strength dictionary (Oooh). 

Let’s say you are designing a pro- 
gram to represent units on a map. You 
know that there will be different kinds 
of units, such as Infantry, Cavalry, and 
Artillery, that have unique characteris- 
tics, but there will also be commonali- 
ties such as the attributes of name and 
strength. In this example, while a unit's 
name is a string object for each unit, the 
strength instance variable takes on a 
different value for each unit. Whereas 
for Infantry this variable stores the 
number of troops, for Cavalry it stores 
the number of mounted troops. An 
Artillery’s strength, finally, is expressed 
in the number of its gun batteries. 

In fact, instead of an integer value 
for Artillery, strength could be 
expressed in terms of a dictionary 
keyed on the different types of guns, 
with an associated value of numbers of 
each. Querying messages sent to each 
unit could return a different composite 
strength value for each, with Infantry 
and Cavalry returning their strength 
instance values unmodified and 
Artillery needing to weigh each gun 
with a strength multiplier, multiplying 
this value by the number of that type 
of gun. (Infantry and Artillery are con- 
sidered polymorphic classes, since they 
respond to the same message with dif- 


ferent behaviors.) The sum of the three 


| ‘ 
values would be returned as 4 nif 


composite strength, 


Everything in Smalltalk is an object; 
object design can be extended further 
to make each gun an object, so the 
strength variable becomes a collection 
of USGun objects. With our base design, 
we add the following subclasses under- 
neath the Object class in the hierarchy: 


USUnit 
USArtillery 
USCavaLry 
USInfantry 


Figure 1 shows the USUnit class struc- 
ture. The USUnit class, which holds the 
name and strength instance variables, is 
considered an abstract object because 
no one will ever create an instance of it. 
Instead, it is meant to share the meth- 
ods and variables inherited by its sub- 
classes, which will have instances cre- 
ated of them. After placing dummy 
methods that return a default answer to 
common methods in this class, the sub- 
classes can choose to implement class- 
specific corresponding methods. While 
USCavalry could then answer true to the 
isMounted method, UVSArtillery and USIn- 
fantry wouldn’t have to implement this 
method because the default method 
isMounted would already exist in the 
USUnit class and would always return 
false, Figure 2 illustrates responses to 
the isMounted message (method). 


USING COLLECTIONS 

Collections, with their many incarna- 
tions, are one of the most used objects 
in Smalltalk, yet because of their flexi- 
bility and availability, developers tend 
to overuse them; their proliferation can 
easily create a drag on program perfor- 
mance. Much of this degradation can 
be traced back to the overhead need to 
support each collection, especially the 
more complex ones, as well as the 
search algorithms used to access or 
retrieve data from their vessels. A care- 
ful examination of the use of instances 
of these objects can dramatically 
increase the speed, efficiency, and 
capacity requirements of your pro- 
gram. If you know the maximum size a 
collection will be, create it with that 
size, as with the statement: 
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:= OrderedCollection new: 


This is better than using OrderedCol- 


lection new, which supplies a default of 


only twelve entries. When the objects to 
be added exceed the size of the collec- 
tion, the collection is forced to grow. 
Even though Smalltalk handles this sit- 
uation automatically, growing is an 
expensive, time-consuming task, espe- 
cially for large collections. Every time a 
collection grows, it must recalculate its 
new size, create a new object with that 
size, and copy the contents of the old 
collection into the new one. The default 
growth size for IndexedCollections, which 
includes OrderedCollections, is: 


self size + (self size // 3 + 10) 


Initializing a collection to its maxi- 
mum size doesn’t bloat the memory 
needed to store the collections as it 
waits to be populated, because new 
entries are initialized to nil values. 

Dictionaries are useful collections 
because they retrieve values immedi- 
ately. This feature comes with a price, 
however; Smalltalk must create and 
maintain their complex structure. Keys 
can be referenced to retrieve values 
quickly, as with: 


unitDict at: “Sth Reg’ 


rather than using other structures or 
stepping through a collection of associ- 
ations: 


unitAssocClt do: [ :anAssoc | 
(anAssoc key = “Sth Reg’) 
ifTrue: [“(anAssoc value)]}]. 


Don’t shy away from using dictio- 
naries, but be sure to use a collection 
right for the job at hand. OrderedCollec- 
tions are cheaper to use than dictionar- 
ies; arrays are cheaper still. 

If a method creates a collection 
every time it is called, make the collec- 
tion an instance or class variable. This 
saves resources otherwise necessary to 
create and return the collection every 
time the method is called, especially if 
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the frequency of calls is high. For exam- 
ple, USArtillery could have a class 
method that initializes and returns a 
dictionary of guns to be used by the 
strength instance variable: 


initStrengthDict 

“((Dictionary new) 
at: “10-pdr. Parrott’ put: 0; 
at: “12-pdr. Whitworth’ put: 0; 
at: “24-pdr. James’ put: 0) 


Now when an instance of USirtillery 
sends a message to itself with self class 
initStrengthDict, it can use the returned 
dictionary as its base. Since dictionar- 
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Garbage collecting 
gives Smalltalk a major 
advantage over C++... It 
frees developers trom 
having to allocate and 
deallocate space when 
interacting with Smalltalk 
methods and objects. 


ies take time to construct, it’s a better 
idea to add the following methods that 
will create the base strength dictionary 
once, store it in a class variable, and 
allow the variable to be retrieved by 
instances of the object or other objects 
as well: 


initClassVars 
strengthDict := self 
initStrengthDict. 
freeClassVars 
strengthDict := nil. 
strengthDict 
“strengthDict 
However, if strengthDict changes, it 
will return the latest changes rather 
than a fresh dictionary until it is reini- 
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tialized. Senders of this method should 
assign their returned dictionary to 
another value if they want to make dis- 
tinct modifications. 

You can streamline searches of a col- 
lection with existing methods such as 
select and collect or with subsets that 
remain stable through a number of 
searches. Try to reduce the number of 
times a collection is searched for a 
value. It is easy to use collections, yet 
the search time naturally and dramati- 
cally grows the larger the collection. 


CREATING VARIABLES 

Whether local, instance, or class, vari- 
ables are easy to set in Smalltalk, since 
their object types need not be declared. 
As with previous examples, with this 
flexibility comes the need for restraint. 
Keeping the number of temporary vari- 
ables down will keep your stack size 
from ballooning unnecessarily, especial- 


For the most part, with 
Smalltalk you don't 
waste time tracking 
down memory errors. 


ly if the methods in which the variables 
reside are called recursively. Limiting 
the use of local variables and keeping 
methods small will speed up your pro- 
gram, since Smalltalk can compile meth- 
ods as the program runs and store more 
of them in a cache before having to 
swap them out for other methods. 
Block statements can be handy, 
especially when setting up error check- 
ing rules. The following example sets 
up a block statement that can be stored 
in a dictionary and used with a collec- 
tion of blocks to check values stored in 
the ErrorCheck object. ErrorCheck will vary 
according to implementation, but in 
this case it stores the values to be 
checked and uses an instance variable 


to store the result of the check: 


block := [ :anErrorCheck | 
anErrorCheck result: (anErrorCheck 
value > 300) | 


If temporary variables are used 
within a block, however, be sure to set 
them to nil after they are used. Other- 
wise, Smalltalk will not be able to 
garbage collect them from the block's 
stack and reclaim their space. This will 
also cause problems if the variable 
points to an object that you think was 
already deleted. 


GARBAGE COLLECTING 
Even those new to Smalltalk are proba- 
bly aware that Smalltalk busies itself at 
times, scurrying around to reclaim 
unused space. Objects that no longer 
have references are cleaned up and 
their space is made available to future 
objects. Objects can be unreferenced 
either when their local variables are no 
longer needed after a method has com- 
pleted or when the variables are set to 
nil. It’s good practice to set all unneed- 
ed instance or class variables to nil. You 
may also want to create initInstVars, 
freeInstVars, initClassVars, and freeClass- 
Vars methods and call them upon the 
initialization and freeing (if postpro- 
cessing needs to be done before the 
object is unreferenced) of an object. 
Garbage collecting gives Smalltalk a 
major advantage over C++ because it 
frees developers from having to allo- 
cate and deallocate space when inter- 
acting with Smalltalk methods and 
objects. However, when. dealing with 
PM structures. and API calls, you will 
need to copy your objects to non- 
Smalltalk memory to prevent the 
garbage collection of objects that span 
the Smalltalk realm. For the most part, 
with Smalltalk you don’t waste time 
tracking down memory errors. 


CONCLUSION 

This article has presented a few tips and 
strategies to help tune your code and 
recommend possible areas for enhanc- 
ing your Smalltalk programming style 


pertaining to the design and develop- 
ment of Smalltalk/V for OS/2 32-bit 
applications. The moral of Smalltalk is, 
“Don’t be afraid to rewrite.” Most code 
is not perfect the first time, and 
Smalltalk allows changes to be made 
and tested quickly. Your code will 
become tighter with a hindsight exami- 
nation, and you'll be able to add to your 
own list of development and perfor- 
mance enhancements. 
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@ here is a good reason why 
your database language was 
developed in C. In fact, there 
are many good reasons. 


C code is small. C code is fast. C code is 
portable. C code is flexible. C is the 
language of choice for today's professional 
developer. With the growing complexity of 
database applications, C is a realistic 
alternative. Now with CodeBase 5.0, you 
can have all the functionality, simplicity and 
power of traditional database languages 
together with the benefits of C/C++. 


C speed - fast code, true executables... 
FoxPro, Clipper, and dBASE were written 
in C primarily for speed. But those compilers 
don't really compile, they combine imbedded 
language interpreters into your .EXE. Now 
that's slow. For dazzling performance you 
need the true executables of C. With 
CodeBase you get the real thing, C code. 
Consider the following statistics, from the 
publisher of Clipper: 








"Sieve of Erastothenes’ 
Benchmark for Prime Number Generation 


Shows C to be incredibly faster ! 


C size - small executables, 

no added overhead... 

FoxPro, Clipper and dBASE would like you 
to believe you need their entire development 
system to build database applications. But 
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FoxPro, Clipper 
and dBASE were all oritten in C. 


remember, those products are all written in 
C. So why do you need to lug all their extra 
code around? You don't. CodeBase is a 
complete DBMS, in C. No fat executables 
stuffed with unused code. No runtime 
modules, No royalties. Just quality C code. 
CodeBase is just what you need. 


C portability - ANSI C/C++ 

on every hardware platform... 

No other language exists on more platforms 
than C/C++. Why rewrite your entire 
application for DOS, Windows, Windows 
NT, OS/2 or UNIX? With CodeBase the 
complete C source code is included, so you 
can port to any platform with an ANSI C or 
C++ compiler. Now and in the future. 


dBASE Compatible data, index 
and memo files... 

You want the industry standard. You need 
compatibility. Sure, (BASE is the standard, 
but every dBASE compatible DBMS 
product uses its own unique index and memo 
file formats. Only CodeBase has them all: 
FoxPro (.cdx), Clipper (.ntx), dBASE IV 
(.mdx) and dBASE III (.ndx). Now it's your 
choice, we're compatible with you. 


_ Announcin 
CodeBase 5. 


The power of a complete DBMS, the benefits of C 


NEW - Multi-user sharing with 
FoxPro, Clipper and dBASE... 
Now your multi-user C/C++ programs can 
share data, index and memo files at the 
same time as concurrently running FoxPro, 
Clipper and dBASE programs. No 
incompatibilities. No waiting. 


NEW - Queries & Relations 
1000 times faster... 


CodeBase 5.0 now lets you query related 


Adar 


data files with any logical dBASE expression. 
Our new Bit Optimization Technology 
(similar to FoxPro's Rushmore technology) 
uses index files to return a query on a 1/2 
million record data file in just a second. 
Automatically take advantage of this query 
performance by using our new CodeReporter: 
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To use CodeReporter, —— 
simply draw your report, then include it in any 
program you write. Call 403/437-2410 new for 
your FREE working model of CodeReporter. 


New - Design complex reports 

in just minutes... 

Our new CodeReporter takes the painstaking 
work out of reports. Now simply design and 
draw reports interactively under Windows 3.1, 
then print or display them from any DOS, 
Windows or UNIX application. 


SPECIAL - FREE CodeReporter 
Order CodeBase 5 before August 30, 1993 
and receive CodeReporter for free! This 
offer includes our no-risk, 90-day money 
back guarantee, so order today! 
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sila Reality 


While the competition plays catch-up, Borland continues to 
lead with the most graphical C and C++ for Windows, DOS, and OS/2. 





with Borland C++ will deliver faster 
because you'll have the most 


To set standards you must 
meet standards 


Borland C++ is the only popular 
compiler that meets the certified 
ANSI C* and AT&T C++ stan- 

| dards. You can be confident that 


A more comfortable place 
to program 

| Borland® C++ gives you the most 
intuitive Integrated Development 
Environment (IDE) for DOS, 
Windows, and OS/2.® This ease of 
use, combined with the fastest C++ 
compilation speed, means you get 












advanced features—like templates 
that make your code smaller, safer, 


and more reusable. 


#1 for real-world 
application development 


With more than one million copies 
| In active use, Borland’s C++ is 


as the language evolves to make 

| programming easier and more 
powerful, your Borland C++ code 
will be ready to take advantage of 

| future versions across all platforms. 


your work done faster. And 
Borland C++ includes time-saving 


C and C++ code generation and | proven, polished, and finely tuned 


| to meet the needs of C and C++ 
programmers. And Borland has the 


Application SERIE WAS.” What’s more, applications built 
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